Partilhar via


DataObject.GetData Método

Definição

Retorna dados em um formato de dados especificado.

Sobrecargas

GetData(String)

Retorna dados em um formato especificado por uma cadeia de caracteres.

GetData(Type)

Retorna um objeto de dados em um formato especificado por um objeto Type.

GetData(String, Boolean)

Retorna um objeto de dados em um formato especificado, convertendo opcionalmente os dados no formato especificado.

GetData(String)

Retorna dados em um formato especificado por uma cadeia de caracteres.

public:
 virtual System::Object ^ GetData(System::String ^ format);
public object GetData (string format);
abstract member GetData : string -> obj
override this.GetData : string -> obj
Public Function GetData (format As String) As Object

Parâmetros

format
String

Uma cadeia de caracteres que especifica o formato dos dados. Para um conjunto de formatos de dados predefinidos, consulte a classe DataFormats.

Retornos

Object

Um objeto que contém os dados no formato especificado ou null se os dados não estiverem disponíveis no formato especificado.

Implementações

Exceções

format é null.

Exemplos

O exemplo a seguir usa esse método para verificar primeiro se um formato de dados especificado está disponível (nativamente ou por conversão automática); se o formato especificado estiver disponível, o exemplo recuperará os dados usando o GetData(String) método.

DataObject dataObject = new DataObject("Some string data to store...");

string desiredFormat = DataFormats.UnicodeText;
byte[] data = null;

// Use the GetDataPresent method to check for the presence of a desired data format.
// This particular overload of GetDataPresent looks for both native and auto-convertible 
// data formats.
if (dataObject.GetDataPresent(desiredFormat))
{
    // If the desired data format is present, use one of the GetData methods to retrieve the
    // data from the data object.
    data = dataObject.GetData(desiredFormat) as byte[];
}
Dim dataObject As New DataObject("Some string data to store...")

Dim desiredFormat As String = DataFormats.UnicodeText
Dim data() As Byte = Nothing

' Use the GetDataPresent method to check for the presence of a desired data format.
' This particular overload of GetDataPresent looks for both native and auto-convertible 
' data formats.
If dataObject.GetDataPresent(desiredFormat) Then
    ' If the desired data format is present, use one of the GetData methods to retrieve the
    ' data from the data object.
    data = TryCast(dataObject.GetData(desiredFormat), Byte())
End If

O código de exemplo a seguir usa o GetDataPresent(String, Boolean) método para verificar primeiro se um formato de dados especificado está disponível nativamente (formatos de dados conversíveis automáticos são filtrados); se o formato especificado estiver disponível, o exemplo recuperará os dados usando o GetData(String) método.

DataObject dataObject = new DataObject("Some string data to store...");

string desiredFormat = DataFormats.UnicodeText;
bool noAutoConvert = false;
byte[] data = null;

// Use the GetDataPresent method to check for the presence of a desired data format.
// The autoconvert parameter is set to false to filter out auto-convertible data formats,
// returning true only if the specified data format is available natively.
if (dataObject.GetDataPresent(desiredFormat, noAutoConvert))
{
    // If the desired data format is present, use one of the GetData methods to retrieve the
    // data from the data object.
    data = dataObject.GetData(desiredFormat) as byte[];
}
Dim dataObject As New DataObject("Some string data to store...")

Dim desiredFormat As String = DataFormats.UnicodeText
Dim noAutoConvert As Boolean = False
Dim data() As Byte = Nothing

' Use the GetDataPresent method to check for the presence of a desired data format.
' The autoconvert parameter is set to false to filter out auto-convertible data formats,
' returning true only if the specified data format is available natively.
If dataObject.GetDataPresent(desiredFormat, noAutoConvert) Then
    ' If the desired data format is present, use one of the GetData methods to retrieve the
    ' data from the data object.
    data = TryCast(dataObject.GetData(desiredFormat), Byte())
End If

Confira também

Aplica-se a

GetData(Type)

Retorna um objeto de dados em um formato especificado por um objeto Type.

public:
 virtual System::Object ^ GetData(Type ^ format);
public object GetData (Type format);
abstract member GetData : Type -> obj
override this.GetData : Type -> obj
Public Function GetData (format As Type) As Object

Parâmetros

format
Type

Um Type que especifica o formato dos dados. Para um conjunto de formatos de dados predefinidos, consulte a classe DataFormats.

Retornos

Object

Um objeto de dados com os dados no formato especificado ou null se os dados estiverem indisponíveis no formato especificado.

Implementações

Exceções

format é null.

Confira também

Aplica-se a

GetData(String, Boolean)

Retorna um objeto de dados em um formato especificado, convertendo opcionalmente os dados no formato especificado.

public:
 virtual System::Object ^ GetData(System::String ^ format, bool autoConvert);
public object GetData (string format, bool autoConvert);
abstract member GetData : string * bool -> obj
override this.GetData : string * bool -> obj
Public Function GetData (format As String, autoConvert As Boolean) As Object

Parâmetros

format
String

Uma cadeia de caracteres que especifica o formato dos dados. Para um conjunto de formatos de dados predefinidos, consulte a classe DataFormats.

autoConvert
Boolean

true para tentar converter automaticamente os dados no formato especificado; false para nenhuma conversão de formato de dados.

Retornos

Object

Um objeto de dados com os dados no formato especificado ou null se os dados estiverem indisponíveis no formato especificado.

Se o parâmetro autoConvert for true e os dados não puderem ser convertidos no formato especificado ou se a conversão automática estiver desabilitada (chamando SetData(String, Object, Boolean) com o parâmetro autoConvert definido como false), esse método retornará null.

Implementações

Exceções

format é nulo.

Confira também

Aplica-se a