Partager via

DataObject.GetData Méthode

Définition

Espace de noms:
System.Windows
Assembly:
PresentationCore.dll

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

Surcharges

Nom Description
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 Type objet.
GetData(String, Boolean)

Retourne un objet de données dans un format spécifié, éventuellement en convertissant les données au 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);
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 obtenir un ensemble de formats de données prédéfinis, consultez la DataFormats classe.

Retours

Object

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

Implémente

GetData(String)

Exceptions

ArgumentNullException

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 Type objet.

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

Paramètres

format
Type

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

Retours

Object

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

Implémente

GetData(Type)

Exceptions

ArgumentNullException

format a la valeur null.

Voir aussi

S’applique à

GetData(String, Boolean)

Retourne un objet de données dans un format spécifié, éventuellement en convertissant les données au format spécifié.

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

Paramètres

format
String

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

autoConvert
Boolean

true pour tenter 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 les données au format spécifié ou null si les données ne sont pas disponibles dans le format spécifié.

Si le autoConvert paramètre 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 autoConvert paramètre défini sur false), cette méthode retourne null.

Implémente

GetData(String, Boolean)

Exceptions

ArgumentNullException

format a la valeur Null.

Voir aussi

S’applique à