Skip to content

ISIAPINetworkFolder Interface

Namespace: SIDRASolutions.SI.API
Assembly: SIDRASolutions.SI.API.dll COM CLSID: C9D53985-EBE9-45CC-8880-3A5684768C62

NetworkFolder wrapper interface

Declaration

[Guid("C9D53985-EBE9-45CC-8880-3A5684768C62")]
public interface ISIAPINetworkFolder

Get an instance

// Navigate to the ISIAPINetworkFolder you need via the ISIAPI tree.
// See ISIAPI for the activation root.
var networkFolder = /* ... */;

' Navigate to the ISIAPINetworkFolder you need via the ISIAPI tree.
' See ISIAPI for the activation root.
Dim networkFolder As ISIAPINetworkFolder = Nothing

# Navigate to the ISIAPINetworkFolder you need via the ISIAPI tree.
# See ISIAPI for the activation root.
networkFolder = ...

# Navigate to the ISIAPINetworkFolder you need via the ISIAPI tree.
# See ISIAPI for the activation root.
$networkFolder = $null

Properties

Name

NetworkFolder name

string Name { get; set; }

Type string

Value

The NetworkFolder name, max length = 100.

Code samples 
string name = networkFolder.Name;
networkFolder.Name = @"Example";

Dim name As String = networkFolder.Name
networkFolder.Name = "Example"

name = networkFolder.Name
networkFolder.Name = r"Example"

$name = $networkFolder.Name
$networkFolder.Name = "Example"

Position

This NetworkFolder Position in the collection. It is a zero-base integer.

int Position { get; }

Type int

Code samples 
int position = networkFolder.Position;

Dim position As Integer = networkFolder.Position

position = networkFolder.Position

$position = $networkFolder.Position

Networks

Collection of Networks in this NetworkFolder

ISIAPINetworks Networks { get; }

Type ISIAPINetworks

Value

Networks collection

Code samples 
var networks = networkFolder.Networks;

Dim networks As ISIAPINetworks = networkFolder.Networks

networks = networkFolder.Networks

$networks = $networkFolder.Networks

Project

ISIAPIProject Project { get; }

Type ISIAPIProject

Code samples 
var project = networkFolder.Project;

Dim project As ISIAPIProject = networkFolder.Project

project = networkFolder.Project

$project = $networkFolder.Project

Methods

AddNetwork(int)

Add a new Network into this NetworkFolder. The new Network does not include any Sites. It is created by using a Standard Software Setup.

ISIAPINetwork AddNetwork(int softwareSetup)

Parameters

Name Type Description
softwareSetup int One of: - Standard Software Setup that is used to create the Network - 1 - Standard Left - 2 - New Zealand - 3 - New South Wales - 4 - Standard Right - 5 - US HCM (Metric) - 6 - US HCM (Customary)

Returns ISIAPINetwork - The new added Network.

Code samples 
var result = networkFolder.AddNetwork(0);

Dim result As ISIAPINetwork = networkFolder.AddNetwork(0)

result = networkFolder.AddNetwork(0)

$result = $networkFolder.AddNetwork(0)

AddNetwork(string)

Add a new Network into this NetworkFolder. The new Network does not include any Sites. It is created by using a User Software Setup or a Standard Software Setup. The Software Setup is identified by the string parameter softwareSetupSignature.

ISIAPINetwork AddNetwork(string softwareSetupSignature)

Parameters

Name Type Description
softwareSetupSignature string The signature string of a User Software Setup or a Standard Software Setup.

Returns ISIAPINetwork - The new added Network.

Code samples 
var result = networkFolder.AddNetwork(@"value");

Dim result As ISIAPINetwork = networkFolder.AddNetwork("value")

result = networkFolder.AddNetwork(r"value")

$result = $networkFolder.AddNetwork("value")

RemoveNetwork(ISIAPINetwork)

Remove a Network from this NetworkFolder.

bool RemoveNetwork(ISIAPINetwork network)

Parameters

Name Type Description
network ISIAPINetwork The Network to remove.

Returns bool - true if the Network is successfully removed; otherwise, false. This method also returns false if the Network does not exist in this Project.

Code samples 
bool result = networkFolder.RemoveNetwork(null);

Dim result As Boolean = networkFolder.RemoveNetwork(Nothing)

result = networkFolder.RemoveNetwork(None)

$result = $networkFolder.RemoveNetwork($null)

CloneNetwork(ISIAPINetwork)

Clone a Network.

ISIAPINetwork CloneNetwork(ISIAPINetwork network)

Parameters

Name Type Description
network ISIAPINetwork The Network to be cloned.

Returns ISIAPINetwork - The new cloned Network.

Remarks

This funciton will create a new Network with the same Sites as those in the original Network, i.e. the Sites will not be cloned.

Code samples 
var result = networkFolder.CloneNetwork(null);

Dim result As ISIAPINetwork = networkFolder.CloneNetwork(Nothing)

result = networkFolder.CloneNetwork(None)

$result = $networkFolder.CloneNetwork($null)

CloneNetworkWithSites(ISIAPINetwork)

Clone a Network with its Sites.

ISIAPINetwork CloneNetworkWithSites(ISIAPINetwork network)

Parameters

Name Type Description
network ISIAPINetwork The Network to be cloned.

Returns ISIAPINetwork - The new cloned Network.

Remarks

This function will clone the Network and its Sites as well, i.e. there will be new cloned Sites in the new cloned Network.

Code samples 
var result = networkFolder.CloneNetworkWithSites(null);

Dim result As ISIAPINetwork = networkFolder.CloneNetworkWithSites(Nothing)

result = networkFolder.CloneNetworkWithSites(None)

$result = $networkFolder.CloneNetworkWithSites($null)

MoveNetworkTo(ISIAPINetwork, int)

Move a Network to a new position in the same NetworkFolder.

bool MoveNetworkTo(ISIAPINetwork network, int newPosition)

Parameters

Name Type Description
network ISIAPINetwork The Network to move.
newPosition int The zero-based position that the Network should be moved to.

Returns bool - true if the Network is successfully moved; otherwise, false. This method also returns false if the Network does not exist in this Project.

Code samples 
bool result = networkFolder.MoveNetworkTo(null, 0);

Dim result As Boolean = networkFolder.MoveNetworkTo(Nothing, 0)

result = networkFolder.MoveNetworkTo(None, 0)

$result = $networkFolder.MoveNetworkTo($null, 0)

MoveNetworksToFolder(string, ISIAPINetworkFolder)

Move Network(s) from this Network Folder to another Network Folder in this Project.

int MoveNetworksToFolder(string networkNames, ISIAPINetworkFolder destFolder)

Parameters

Name Type Description
networkNames string The name(s) of the Network(s) to move. Use semicolon ";" to separate the names. If a name already has ";", replace each ";" with ";;". For examples:
destFolder ISIAPINetworkFolder The destination Network Folder

Returns int - The number of successfully moved Networks

Code samples 
int result = networkFolder.MoveNetworksToFolder(@"City Network", null);

Dim result As Integer = networkFolder.MoveNetworksToFolder("City Network", Nothing)

result = networkFolder.MoveNetworksToFolder(r"City Network", None)

$result = $networkFolder.MoveNetworksToFolder("City Network", $null)