DataTableCollection.Item[] Propiedad

Definición

Espacio de nombres:

System.Data

Ensamblado:

System.Data.Common.dll

Ensamblado:

System.Data.dll

Ensamblado:

netstandard.dll

Obtiene el objeto DataTable especificado de la colección.

Sobrecargas

Item[Int32]	Obtiene el objeto DataTable en el índice especificado.
Item[String]	Obtiene el DataTable con el nombre especificado.
Item[String, String]	Obtiene el objeto DataTable con el nombre especificado en el espacio de nombres indicado.

Item[Int32]

Obtiene el objeto DataTable en el índice especificado.

public:
 property System::Data::DataTable ^ default[int] { System::Data::DataTable ^ get(int index); };

public System.Data.DataTable this[int index] { get; }

member this.Item(int) : System.Data.DataTable

Default Public ReadOnly Property Item(index As Integer) As DataTable

Parámetros

index

Int32

El índice de base cero de DataTable que se va a buscar.

Valor de propiedad

DataTable

con DataTable el índice especificado; de lo contrario null , si DataTable no existe .

Excepciones

IndexOutOfRangeException

El valor de índice es mayor que el número de elementos de la colección.

Ejemplos

En el ejemplo siguiente se recupera un DataTable objeto por su índice.

private void GetDataTableByIndex()
{
   // presuming a DataGrid is displaying more than one table, get its DataSet.
   DataSet thisDataSet = (DataSet)DataGrid1.DataSource;
   // Get the DataTableCollection.
   DataTableCollection tablesCollection = thisDataSet.Tables;
   // Iterate through the collection to get each table name.
   for (int i = 0; i < tablesCollection.Count; i++)
      Console.WriteLine(tablesCollection[i].TableName);
}

Private Sub GetDataTableByIndex()
    ' Presuming a DataGrid is displaying more than one table, get its DataSet.
    Dim thisDataSet As DataSet = CType(DataGrid1.DataSource, DataSet)

    ' Get the DataTableCollection.
    Dim tablesCollection As DataTableCollection = thisDataSet.Tables

    ' Iterate through the collection to get each table name.
    Dim i As Integer
    For i = 0 To tablesCollection.Count - 1
       Console.WriteLine(tablesCollection(i).TableName)
    Next
End Sub

Comentarios

Use el Contains método para determinar si existe una tabla con un índice específico.

Si tiene el nombre de una tabla, pero no su índice, use el IndexOf método para devolver el índice.

Consulte también

• Contains(String)
• IndexOf(DataTable)
• DataTable

Item[String]

Obtiene el DataTable con el nombre especificado.

public:
 property System::Data::DataTable ^ default[System::String ^] { System::Data::DataTable ^ get(System::String ^ name); };

public System.Data.DataTable? this[string? name] { get; }

public System.Data.DataTable this[string name] { get; }

member this.Item(string) : System.Data.DataTable

Default Public ReadOnly Property Item(name As String) As DataTable

Parámetros

name

String

Nombre de DataTable que se va a buscar.

Valor de propiedad

DataTable

DataTable con el nombre especificado; en caso contrario, null si DataTable no existe.

Ejemplos

En el ejemplo siguiente se recupera una sola tabla por nombre de DataTableCollection.

private void GetTableByName()
{
    // Presuming a DataGrid is displaying more than one table, get its DataSet.
    DataSet thisDataSet = (DataSet)DataGrid1.DataSource;

    // Get the DataTableCollection.
    DataTableCollection tablesCollection = thisDataSet.Tables;

    // Get a specific table by name.
    DataTable table = tablesCollection["Suppliers"];
    Console.WriteLine(table.TableName);
}

Private Sub GetTableByName()
    ' Presuming a DataGrid is displaying more than one table, 
    ' get its DataSet.
    Dim thisDataSet As DataSet = CType(DataGrid1.DataSource, DataSet)

    ' Get the DataTableCollection.
    Dim tablesCollection As DataTableCollection = thisDataSet.Tables

    ' Get a specific table by name.
    Dim table As DataTable = tablesCollection("Suppliers")
    Console.WriteLine(table.TableName)
End Sub

Comentarios

Si existe un DataTable nombre que coincide con el caso de la cadena de búsqueda, se devuelve. De lo contrario, se realiza una búsqueda sin distinción entre mayúsculas y minúsculas y, si se encuentra un DataTable nombre que coincide con esta búsqueda, se devuelve.

Use el Contains método para determinar si existe una tabla con un nombre o índice específico.

Item[String, String]

Obtiene el objeto DataTable con el nombre especificado en el espacio de nombres indicado.

public:
 property System::Data::DataTable ^ default[System::String ^, System::String ^] { System::Data::DataTable ^ get(System::String ^ name, System::String ^ tableNamespace); };

public System.Data.DataTable? this[string? name, string tableNamespace] { get; }

public System.Data.DataTable this[string name, string tableNamespace] { get; }

member this.Item(string * string) : System.Data.DataTable

Default Public ReadOnly Property Item(name As String, tableNamespace As String) As DataTable

Parámetros

name

String

Nombre de DataTable que se va a buscar.

tableNamespace

String

Nombre del espacio de nombres de DataTable en el que se va a buscar.

Valor de propiedad

DataTable

DataTable con el nombre especificado; en caso contrario, null si DataTable no existe.