DataObject.GetData Méthode

Définition

Retourne des données dans un format de données spécifié.

Surcharges

GetData(String)

Retourne des données dans un format spécifié par une chaîne.

GetData(Type)

Retourne un objet de données dans un format spécifié par un objet Type.

GetData(String, Boolean)

Retourne un objet de données dans un format spécifié, en convertissant de façon facultative les données en format spécifié.

GetData(String)

Retourne des données dans un format spécifié par une chaîne.

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

Paramètres

format
String

Chaîne qui spécifie le format des données. Pour un ensemble de formats de données prédéfinis, consultez la classe DataFormats.

Retours

Object

Objet qui contient les données au format spécifié, ou null si les données ne sont pas disponibles au format spécifié.

Implémente

Exceptions

format a la valeur null.

Exemples

L’exemple suivant utilise cette méthode pour vérifier d’abord si un format de données spécifié est disponible (en mode natif ou par conversion automatique) ; si le format spécifié est disponible, l’exemple récupère les données à l’aide de la GetData(String) méthode.

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

L’exemple de code suivant utilise la GetDataPresent(String, Boolean) méthode pour vérifier d’abord si un format de données spécifié est disponible en mode natif (les formats de données convertibles automatiquement sont filtrés) ; si le format spécifié est disponible, l’exemple récupère les données à l’aide de la GetData(String) méthode.

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

Voir aussi

S’applique à

GetData(Type)

Retourne un objet de données dans un format spécifié par un objet 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

Paramètres

format
Type

Type qui spécifie le format des données. Pour un ensemble de formats de données prédéfinis, consultez la classe DataFormats.

Retours

Object

Objet de données avec des données au format spécifié, ou null si les données ne sont pas disponibles au format spécifié.

Implémente

Exceptions

format a la valeur null.

Voir aussi

S’applique à

GetData(String, Boolean)

Retourne un objet de données dans un format spécifié, en convertissant de façon facultative les données en format spécifié.

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

Paramètres

format
String

Chaîne qui spécifie le format des données. Pour un ensemble de formats de données prédéfinis, consultez la classe DataFormats.

autoConvert
Boolean

true pour essayer de convertir automatiquement les données au format spécifié ; false pour aucune conversion de format de données.

Retours

Object

Objet de données avec des données au format spécifié, ou null si les données ne sont pas disponibles au format spécifié.

Si le paramètre autoConvert est true et que les données ne peuvent pas être converties au format spécifié, ou si la conversion automatique est désactivée (en appelant SetData(String, Object, Boolean) avec le paramètre autoConvert ayant la valeur false), cette méthode retourne null.

Implémente

Exceptions

format a la valeur null.

Voir aussi

S’applique à