RegionRepository.Restore Method

Restore existing regions by restore mode.

Namespace: Gamanet.C4.SDK
Assembly: Gamanet.C4.SimpleClient (in Gamanet.C4.SimpleClient.dll) Version: 2026.0.0.733
Syntax
C#
public void Restore(
	SimpleRegionV1 region,
	RestoreMode restoreMode
)

Parameters

region  SimpleRegionV1
The region.
restoreMode  RestoreMode
The restore mode

Implements

ISimpleClientRegionRepositoryV1.Restore(SimpleRegionV1, RestoreMode)
Example
The following example illustrates how the SimpleClient restores region with children.
C#
using System;
using Gamanet.C4.SDK;
using Gamanet.C4.SimpleInterfaces;

public class Example
{
    static void Main()
    {
        // Create instance of simple client
        var client = new SimpleClient(ConnectorConfiguration.HttpClient);

        ConnectionInfoV1 token;
        // Connect to local server
        var connectionResult = client.Connect(new Uri("https://localhost/"), "Support", "support", out token);

        if (connectionResult != ConnectionResult.Successful)
        {
            Console.WriteLine("Connection unsuccessful, result: {0}", connectionResult);
            return;
        }

        Console.WriteLine("Connection result: {0}", connectionResult);
        Console.WriteLine();

        // Create Example Region
        var exampleParentRegion = new SimpleRegionV1(
            Guid.NewGuid(),
            "exampleParentRegion",
            EntityRoot.Region,
            RegionCategory.Region
            );
        // Create Example Region in database
        client.Regions.Create(exampleParentRegion);

        // Create Example Region
        var exampleChildRegion = new SimpleRegionV1(
            Guid.NewGuid(),
            "exampleChildRegion",
            exampleParentRegion.Id,
            RegionCategory.Region
            );
        // Create Example Region in database
        client.Regions.Create(exampleChildRegion);

        // Archive the regions
        client.Regions.Archive(exampleParentRegion);

        foreach(var region in client.Regions.GetAll())
        {
            Console.WriteLine($"{region.Name} -> {region.Archived}");
        }

        client.Regions.Restore(exampleParentRegion, RestoreMode.WithChildren);

        foreach (var region in client.Regions.GetAll())
        {
            Console.WriteLine($"{region.Name} -> {region.Archived}");
        }

        // Disconnect from server
        client.Disconnect();
    }
}
The following example illustrates how the SimpleClient Restores region with parent.
C#
using System;
using Gamanet.C4.SDK;
using Gamanet.C4.SimpleInterfaces;

public class Example
{
    static void Main()
    {
        // Create instance of simple client
        var client = new SimpleClient(ConnectorConfiguration.HttpClient);

        ConnectionInfoV1 token;
        // Connect to local server
        var connectionResult = client.Connect(new Uri("https://localhost/"), "Support", "support", out token);

        if (connectionResult != ConnectionResult.Successful)
        {
            Console.WriteLine("Connection unsuccessful, result: {0}", connectionResult);
            return;
        }

        Console.WriteLine("Connection result: {0}", connectionResult);
        Console.WriteLine();

        // Create Example Region
        var exampleParentRegion = new SimpleRegionV1(
            Guid.NewGuid(),
            "exampleParentRegion",
            EntityRoot.Region,
            RegionCategory.Region
            );
        // Create Example Region in database
        client.Regions.Create(exampleParentRegion);
        // Create Example Region
        var exampleChildRegion = new SimpleRegionV1(
            Guid.NewGuid(),
            "exampleChildRegion",
            exampleParentRegion.Id,
            RegionCategory.Region
            );
        // Create Example Region in database
        client.Regions.Create(exampleChildRegion);

        // archive the regions
        client.Regions.Archive(exampleParentRegion);

        foreach (var region in client.Regions.GetAll())
        {
            Console.WriteLine($"{region.Name} -> {region.Archived}");
        }

        client.Regions.Restore(exampleChildRegion, RestoreMode.WithParents);

        foreach (var region in client.Regions.GetAll())
        {
            Console.WriteLine($"{region.Name} -> {region.Archived}");
        }

        // Disconnect from server
        client.Disconnect();
    }
}
The following example illustrates how the SimpleClient Restores single region.
C#
using System;
using Gamanet.C4.SDK;
using Gamanet.C4.SimpleInterfaces;

public class Example
{
    static void Main()
    {
        // Create instance of simple client
        var client = new SimpleClient(ConnectorConfiguration.HttpClient);

        ConnectionInfoV1 token;
        // Connect to local server
        var connectionResult = client.Connect(new Uri("https://localhost/"), "Support", "support", out token);

        if (connectionResult != ConnectionResult.Successful)
        {
            Console.WriteLine("Connection unsuccessful, result: {0}", connectionResult);
            return;
        }

        Console.WriteLine("Connection result: {0}", connectionResult);
        Console.WriteLine();

        // Create Example Region
        var exampleParentRegion = new SimpleRegionV1(
            Guid.NewGuid(),
            "exampleParentRegion",
            EntityRoot.Region,
            RegionCategory.Region
            );

        // Create Example Region in database
        client.Regions.Create(exampleParentRegion);

        // Create Example Region
        var exampleChildRegion = new SimpleRegionV1(
            Guid.NewGuid(),
            "exampleChildRegion",
            exampleParentRegion.Id,
            RegionCategory.Region
            );
        // Create Example Region in database
        client.Regions.Create(exampleChildRegion);

        // Archve the regions
        client.Regions.Archive(exampleParentRegion);

        foreach (var region in client.Regions.GetAll())
        {
            Console.WriteLine($"{region.Name} -> {region.Archived}");
        }

        client.Regions.Restore(exampleParentRegion, RestoreMode.Single);

        foreach (var region in client.Regions.GetAll())
        {
            Console.WriteLine($"{region.Name} -> {region.Archived}");
        }

        // Disconnect from server
        client.Disconnect();
    }
}
See Also

Reference

RegionRepository Class
Gamanet.C4.SDK Namespace
SimpleRegionV1
RestoreMode