Partager via


DataObject.GetFormats Méthode

Définition

Retourne une liste de formats dans laquelle les données de cet objet de données sont stockées ou vers laquelle elles peuvent être converties.

Surcharges

GetFormats()

Retourne une liste de formats dans laquelle les données de cet objet de données sont stockées ou vers laquelle elles peuvent être converties.

GetFormats(Boolean)

Retourne une liste de formats dans laquelle les données dans cet objet de données sont stockées. Un indicateur Boolean indique s'il faut inclure également des formats auxquels les données peuvent être converties automatiquement.

GetFormats()

Retourne une liste de formats dans laquelle les données de cet objet de données sont stockées ou vers laquelle elles peuvent être converties.

public:
 virtual cli::array <System::String ^> ^ GetFormats();
public string[] GetFormats ();
abstract member GetFormats : unit -> string[]
override this.GetFormats : unit -> string[]
Public Function GetFormats () As String()

Retours

String[]

Tableau de chaînes, dont chaque chaîne spécifie le nom d'un format que cet objet de données prend en charge.

Implémente

Exemples

L’exemple suivant utilise cette méthode pour obtenir un tableau de chaînes indiquant tous les formats de données disponibles dans un objet de données (natif et convertible automatiquement).

DataObject dataObject = new DataObject("Some string data to store...");

// Get an array of strings, each string denoting a data format
// that is available in the data object.  This overload of GetDataFormats
// returns all available data formats, native and auto-convertible.
string[] dataFormats = dataObject.GetFormats();

// Get the number of data formats present in the data object, including both
// auto-convertible and native data formats.
int numberOfDataFormats = dataFormats.Length;

// To enumerate the resulting array of data formats, and take some action when
// a particular data format is found, use a code structure similar to the following.
foreach (string dataFormat in dataFormats)
{
    if (dataFormat == DataFormats.Text)
    {
        // Take some action if/when data in the Text data format is found.
        break;
    }
    else if(dataFormat == DataFormats.StringFormat)
    {
        // Take some action if/when data in the string data format is found.
        break;
    }
}
Dim dataObject As New DataObject("Some string data to store...")

' Get an array of strings, each string denoting a data format
' that is available in the data object.  This overload of GetDataFormats
' returns all available data formats, native and auto-convertible.
Dim dataFormats() As String = dataObject.GetFormats()

' Get the number of data formats present in the data object, including both
' auto-convertible and native data formats.
Dim numberOfDataFormats As Integer = dataFormats.Length

' To enumerate the resulting array of data formats, and take some action when
' a particular data format is found, use a code structure similar to the following.
For Each dataFormat As String In dataFormats
    If dataFormat = System.Windows.DataFormats.Text Then
        ' Take some action if/when data in the Text data format is found.
        Exit For
    ElseIf dataFormat = System.Windows.DataFormats.StringFormat Then
        ' Take some action if/when data in the string data format is found.
        Exit For
    End If
Next dataFormat

Remarques

Pour un ensemble de formats de données prédéfinis, consultez la classe DataFormats.

S’applique à

GetFormats(Boolean)

Retourne une liste de formats dans laquelle les données dans cet objet de données sont stockées. Un indicateur Boolean indique s'il faut inclure également des formats auxquels les données peuvent être converties automatiquement.

public:
 virtual cli::array <System::String ^> ^ GetFormats(bool autoConvert);
public string[] GetFormats (bool autoConvert);
abstract member GetFormats : bool -> string[]
override this.GetFormats : bool -> string[]
Public Function GetFormats (autoConvert As Boolean) As String()

Paramètres

autoConvert
Boolean

true pour récupérer tous les formats dans lesquels les données dans cet objet de données sont stockées ou auxquels elles peuvent être converties ; false pour récupérer uniquement les formats auxquels les données dans cet objet de données sont stockées.

Retours

String[]

Tableau de chaînes, dont chaque chaîne spécifie le nom d'un format pris en charge par cet objet de données.

Implémente

Exemples

L’exemple suivant utilise cette méthode pour obtenir un tableau de chaînes indiquant uniquement les formats de données disponibles dans un objet de données (les formats de données convertibles automatiquement sont filtrés).

DataObject dataObject = new DataObject("Some string data to store...");

// Get an array of strings, each string denoting a data format
// that is available in the data object.  This overload of GetDataFormats
// accepts a Boolean parameter inidcating whether to include auto-convertible
// data formats, or only return native data formats.
string[] dataFormats = dataObject.GetFormats(false /* Include auto-convertible? */);

// Get the number of native data formats present in the data object.
int numberOfDataFormats = dataFormats.Length;

// To enumerate the resulting array of data formats, and take some action when
// a particular data format is found, use a code structure similar to the following.
foreach (string dataFormat in dataFormats)
{
    if (dataFormat == DataFormats.Text)
    {
        // Take some action if/when data in the Text data format is found.
        break;
    }
}
Dim dataObject As New DataObject("Some string data to store...")

' Get an array of strings, each string denoting a data format
' that is available in the data object.  This overload of GetDataFormats
' accepts a Boolean parameter inidcating whether to include auto-convertible
' data formats, or only return native data formats.
Dim dataFormats() As String = dataObject.GetFormats(False) ' Include auto-convertible? 

' Get the number of native data formats present in the data object.
Dim numberOfDataFormats As Integer = dataFormats.Length

' To enumerate the resulting array of data formats, and take some action when
' a particular data format is found, use a code structure similar to the following.
For Each dataFormat As String In dataFormats
    If dataFormat = System.Windows.DataFormats.Text Then
        ' Take some action if/when data in the Text data format is found.
        Exit For
    End If
Next dataFormat

Remarques

Pour un ensemble de formats de données prédéfinis, consultez la classe DataFormats.

S’applique à