TraceCollection.Insert Method

Definition

Namespace:

Microsoft.AnalysisServices

Assembly:

Microsoft.AnalysisServices.dll

Package:

Microsoft.AnalysisServices v19.87.2

Overloads

Insert(Int32, String, String)	Creates a new Trace object using the specified name and identifier, inserts it to the collection at the specified index and returns the new Trace created.
Insert(Int32, String)	Creates a new Trace object using the specified name, inserts it to the collection at the specified index and returns the new Trace created.
Insert(Int32, Trace)	Inserts the specified Trace to the collection at the specified index.
Insert(Int32)	Creates a new Trace object using a generated unique Name and identifier, inserts it to the collection at the specified index and returns the new Trace created.

Insert(Int32, String, String)

Creates a new Trace object using the specified name and identifier, inserts it to the collection at the specified index and returns the new Trace created.

public Microsoft.AnalysisServices.Trace Insert (int index, string name, string id);

override this.Insert : int * string * string -> Microsoft.AnalysisServices.Trace

Public Function Insert (index As Integer, name As String, id As String) As Trace

Parameters

index

Int32

The zero-based index at which the Trace is inserted.

name

String

The Name for the new Trace object.

id

String

The identifier for the new Trace object.

Returns

Trace

The newly created Trace object.

Exceptions

ArgumentOutOfRangeException

The specified index is not a valid value (less than zero or bigger then the total number of elements).

InvalidOperationException

• The specified name is not valid in the collection.
• The specified identifier is not valid in the collection.

Insert(Int32, String)

Creates a new Trace object using the specified name, inserts it to the collection at the specified index and returns the new Trace created.

public Microsoft.AnalysisServices.Trace Insert (int index, string name);

override this.Insert : int * string -> Microsoft.AnalysisServices.Trace

Public Function Insert (index As Integer, name As String) As Trace

Parameters

index

Int32

The zero-based index at which the Trace is inserted.

name

String

The Name for the new Trace object. It must be unique within the collection.

Returns

Trace

The newly created Trace object.

Exceptions

ArgumentOutOfRangeException

The specified index is not a valid value (less than zero or bigger then the total number of elements).

InvalidOperationException

The specified name is not valid in the collection.

Remarks

The identifier for the Trace is generated based on the specified Name.

Insert(Int32, Trace)

Inserts the specified Trace to the collection at the specified index.

public void Insert (int index, Microsoft.AnalysisServices.Trace item);

override this.Insert : int * Microsoft.AnalysisServices.Trace -> unit

Public Sub Insert (index As Integer, item As Trace)

Parameters

index

Int32

The zero-based index at which the Trace is inserted.

item

Trace

The Trace to be inserted.

Exceptions

ArgumentOutOfRangeException

The specified index is not a valid value (less than zero or bigger then the total number of elements).

InvalidOperationException

• The specified item is a null reference (Nothing in Visual Basic).
• The specified item already esists in the collection.
• The identifier of the specified Trace is not valid in the collection.
• The name of the specified Trace is not valid in the collection.
• The compatibility-level of the specified Trace is not valid in the collection.

Insert(Int32)

Creates a new Trace object using a generated unique Name and identifier, inserts it to the collection at the specified index and returns the new Trace created.

public Microsoft.AnalysisServices.Trace Insert (int index);

override this.Insert : int -> Microsoft.AnalysisServices.Trace

Public Function Insert (index As Integer) As Trace

Parameters

index

Int32

The zero-based index at which the Trace is inserted.

Returns

Trace

The newly created Trace object.

Exceptions

ArgumentOutOfRangeException

The specified index is not a valid value (less than zero or bigger then the total number of elements).