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

Devoluciones

Object

Objeto que contiene los datos en el formato especificado o su valor es null si los datos no están disponibles en el formato especificado.

Implementaciones

Excepciones

Ejemplos

En el ejemplo siguiente se usa este método para comprobar primero si un formato de datos especificado está disponible (de forma nativa o mediante la conversión automática); si el formato especificado está disponible, el ejemplo recupera los datos mediante el 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

En el código de ejemplo siguiente se usa el GetDataPresent(String, Boolean) método para comprobar primero si un formato de datos especificado está disponible de forma nativa (se filtran los formatos de datos convertibles automáticamente); si el formato especificado está disponible, el ejemplo recupera los datos mediante el 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

Consulte también

• Cargar un ejemplo de archivo quitado

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

Devoluciones

Object

Objeto de datos con los datos en el formato especificado o su valor es null si los datos no están disponibles en el formato especificado.

Implementaciones

Excepciones

Consulte también

• Cargar un ejemplo de archivo quitado

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

Devoluciones

Object

Objeto de datos con los datos en el formato especificado o su valor es null si los datos no están disponibles en el formato especificado.

Si el valor del parámetro autoConvert es true y los datos no se pueden convertir al formato especificado; o bien, si está deshabilitada la conversión automática (llamando a SetData(String, Object, Boolean) con el valor del parámetro autoConvert establecido en false), este método devuelve null.

Implementaciones

Excepciones

Consulte también

• Cargar un ejemplo de archivo quitado