Compartir a través de


DataObject.GetData Método

Definición

Devuelve los datos en un formato de datos especificado.

Sobrecargas

GetData(String)

Devuelve los datos en un formato especificado por una cadena.

GetData(Type)

Devuelve un objeto de datos con un formato especificado por un objeto Type.

GetData(String, Boolean)

Devuelve un objeto de datos con un formato especificado, convirtiendo opcionalmente los datos al formato especificado.

GetData(String)

Devuelve los datos en un formato especificado por una cadena.

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

Cadena que especifica el formato de los datos. Para ver un conjunto de formatos de datos predefinidos, consulte la clase DataFormats.

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

format es null.

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

Se aplica a

GetData(Type)

Devuelve un objeto de datos con un formato especificado por un 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

Type que especifica el formato de los datos. Para ver un conjunto de formatos de datos predefinidos, consulte la clase DataFormats.

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

format es null.

Consulte también

Se aplica a

GetData(String, Boolean)

Devuelve un objeto de datos con un formato especificado, convirtiendo opcionalmente los datos al 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

Cadena que especifica el formato de los datos. Para ver un conjunto de formatos de datos predefinidos, consulte la clase DataFormats.

autoConvert
Boolean

Es true para intentar convertir automáticamente los datos al formato especificado; es false si no se produce ninguna conversión.

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

format es NULL.

Consulte también

Se aplica a