DataTableReader.GetString(Int32) Método

Definição

Namespace:

System.Data

Assembly:

System.Data.Common.dll

Origem:

DataTableReader.cs

Obtém o valor da coluna especificada como uma cadeia de caracteres.

public:
 override System::String ^ GetString(int ordinal);

public override string GetString (int ordinal);

override this.GetString : int -> string

Public Overrides Function GetString (ordinal As Integer) As String

Parâmetros

ordinal

Int32

O ordinal da coluna baseado em zero.

Retornos

String

O valor da coluna especificada.

Exceções

ArgumentOutOfRangeException

O índice passado estava fora do intervalo de 0 a FieldCount -1.

DeletedRowInaccessibleException

Foi feita uma tentativa de recuperar dados de uma linha excluída.

InvalidOperationException

Foi feita uma tentativa de ler ou acessar uma coluna em um DataTableReader fechado.

InvalidCastException

A coluna especificada não contém uma cadeia de caracteres.

Exemplos

O exemplo a seguir exibe o conteúdo da coluna numerada 2 dentro do passado DataTableReader. Se o valor da coluna dentro de uma linha específica for nulo, o código exibirá o texto <NULL>. Se os dados dentro da coluna do tipo correto, o exemplo exibirá uma mensagem de erro para cada linha.

private static void PrintColumn(DataTableReader reader)
{
    // Loop through all the rows in the DataTableReader
    while (reader.Read())
    {
        if (reader.IsDBNull(2))
        {
            Console.Write("<NULL>");
        }
        else
        {
            try
            {
                Console.Write(reader.GetString(2));
            }
            catch (InvalidCastException)
            {
                Console.Write("Invalid data type.");
            }
        }
        Console.WriteLine();
    }
}

Private Sub PrintColumn(ByVal reader As DataTableReader)
   ' Loop through all the rows in the DataTableReader
   While reader.Read()
      If reader.IsDBNull(2) Then
         Console.Write("<NULL>")
      Else
         Try
            Console.Write(reader.GetString(2))
         Catch ex As InvalidCastException
            Console.Write("Invalid data type.")
         End Try
      End If
      Console.WriteLine()
   End While
End Sub

Comentários

Chame IsDBNull para ver se há valores nulos antes de chamar esse método.