DataObject.GetFormats Metodo

Definizione

Spazio dei nomi:

System.Windows

Assembly:

PresentationCore.dll

Restituisce un elenco di formati nel quale i dati in questo oggetto dati sono archiviati, o possono essere convertiti.

Overload

GetFormats()	Restituisce un elenco di formati nel quale i dati in questo oggetto dati sono archiviati, o possono essere convertiti.
GetFormats(Boolean)	Restituisce un elenco di formati nel quale i dati in questo oggetto dati sono archiviati. Un flag Boolean indica se includere anche formati nei quali i dati possono essere convertiti automaticamente.

GetFormats()

Restituisce un elenco di formati nel quale i dati in questo oggetto dati sono archiviati, o possono essere convertiti.

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()

Restituisce

String[]

Una matrice di stringhe, con ogni stringa che specifica il nome di un formato che questo oggetto dati supporta.

Implementazioni

GetFormats()

Esempio

Nell'esempio seguente viene usato questo metodo per ottenere una matrice di stringhe che denonono tutti i formati di dati disponibili in un oggetto dati (sia nativo che convertibile automaticamente).

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

Commenti

Per un set di formati dati predefiniti, vedere la classe DataFormats.

GetFormats(Boolean)

Restituisce un elenco di formati nel quale i dati in questo oggetto dati sono archiviati. Un flag Boolean indica se includere anche formati nei quali i dati possono essere convertiti automaticamente.

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()

Parametri

autoConvert

Boolean

true per recuperare tutti i formati nei quali sono archiviati i dati in questo oggetto dati, o possono essere convertito; false per recuperare solo formati nei quali sono archiviati i dati in questo oggetto dati.

Restituisce

String[]

Una matrice di stringhe, con ogni stringa che specifica il nome di un formato supportato da questo oggetto dati.

Implementazioni

GetFormats(Boolean)

Esempio

Nell'esempio seguente viene usato questo metodo per ottenere una matrice di stringhe che denonono solo i formati di dati disponibili in un oggetto dati (i formati di dati convertibili automaticamente vengono filtrati).

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

Commenti

Per un set di formati dati predefiniti, vedere la classe DataFormats.