DataObject.GetData Método

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

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

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

• Carregar um exemplo de arquivo descartado

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

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

Confira também

• Carregar um exemplo de arquivo descartado

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

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

Confira também

• Carregar um exemplo de arquivo descartado