DataObject.GetData Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Devuelve datos en un formato de datos especificado.
Sobrecargas
| Nombre | Description |
|---|---|
| GetData(String) |
Devuelve datos en un formato especificado por una cadena. |
| GetData(Type) |
Devuelve un objeto de datos en un formato especificado por un Type objeto . |
| GetData(String, Boolean) |
Devuelve un objeto de datos en un formato especificado y, opcionalmente, convierte los datos en el formato especificado. |
GetData(String)
Devuelve datos en un formato especificado por una cadena.
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
- format
- String
Cadena que especifica el formato de los datos. Para obtener un conjunto de formatos de datos predefinidos, consulte la DataFormats clase .
Devoluciones
Objeto que contiene los datos en el formato especificado o 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 hay disponible un formato de datos especificado (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
El código de ejemplo siguiente 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 en un formato especificado por un Type objeto .
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
- format
- Type
que Type especifica el formato de los datos. Para obtener un conjunto de formatos de datos predefinidos, consulte la DataFormats clase .
Devoluciones
Objeto de datos con los datos en el formato especificado o 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 en un formato especificado y, opcionalmente, convierte los datos en el formato especificado.
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
- format
- String
Cadena que especifica el formato de los datos. Para obtener un conjunto de formatos de datos predefinidos, consulte la DataFormats clase .
- autoConvert
- Boolean
true para intentar convertir automáticamente los datos en el formato especificado; false para ninguna conversión de formato de datos.
Devoluciones
Objeto de datos con los datos en el formato especificado o null si los datos no están disponibles en el formato especificado.
Si el autoConvert parámetro es true y los datos no se pueden convertir al formato especificado, o si la conversión automática está deshabilitada (llamando a SetData(String, Object, Boolean) con el autoConvert parámetro establecido falseen ), este método devuelve null.
Implementaciones
Excepciones
format es null.