TraceCollection.Insert Method

Definition

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

The newly created Trace object.

Exceptions

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

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

Applies to

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

The newly created Trace object.

Exceptions

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

The specified name is not valid in the collection.

Remarks

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

Applies to

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

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

  • 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.

Applies to

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

The newly created Trace object.

Exceptions

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

Applies to