DataObject.GetData Método

public:
 virtual System::Object ^ GetData(System::String ^ format);

public object GetData(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

Devoluções

Um objeto que contenha 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 seguinte utiliza este método para primeiro verificar se um formato de dados especificado está disponível (nativamente ou por auto-conversão); Se o formato especificado estiver disponível, o exemplo recupera 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 seguinte código de exemplo utiliza o GetDataPresent(String, Boolean) método para verificar primeiro se um formato de dados especificado está disponível nativamente (os formatos de dados auto-convertíveis são filtrados); se o formato especificado estiver disponível, o exemplo recupera 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

Ver também

• Carregar uma Amostra de Ficheiro Perdida

public:
 virtual System::Object ^ GetData(Type ^ format);

public 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

Devoluções

Um objeto de dados com os dados no formato especificado, ou null se os dados não estiverem disponíveis no formato especificado.

Implementações

Exceções

Ver também

• Carregar uma Amostra de Ficheiro Perdida

public:
 virtual System::Object ^ GetData(System::String ^ format, bool autoConvert);

public object GetData(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

Devoluções

Um objeto de dados com os dados no formato especificado, ou null se os dados não estiverem disponíveis no formato especificado.

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

Implementações

Exceções

Ver também

• Carregar uma Amostra de Ficheiro Perdida