DataObject.GetFormats Metoda

Definice

Obor názvů:

System.Windows

Sestavení:

PresentationCore.dll

Vrátí seznam formátů, ve kterých jsou uložena data v tomto datovém objektu, nebo lze převést na.

Přetížení

GetFormats()	Vrátí seznam formátů, ve kterých jsou uložena data v tomto datovém objektu, nebo lze převést na.
GetFormats(Boolean)	Vrátí seznam formátů, ve kterých jsou uložena data v tomto datovém objektu. Příznak Boolean označuje, jestli se mají zahrnout i formáty, na které lze data automaticky převést.

GetFormats()

Vrátí seznam formátů, ve kterých jsou uložena data v tomto datovém objektu, nebo lze převést na.

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

Návraty

String[]

Pole řetězců s každým řetězcem určujícím název formátu, který tento datový objekt podporuje.

Implementuje

GetFormats()

Příklady

Následující příklad používá tuto metodu k získání pole řetězců, které označují všechny formáty dat dostupné v datovém objektu (nativní i automaticky se sklápěcí).

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

Poznámky

Sadu předdefinovaných datových formátů najdete ve DataFormats třídě.

GetFormats(Boolean)

Vrátí seznam formátů, ve kterých jsou uložena data v tomto datovém objektu. Příznak Boolean označuje, jestli se mají zahrnout i formáty, na které lze data automaticky převést.

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

Parametry

autoConvert

Boolean

true načíst všechny formáty, ve kterých jsou uložena data v tomto datovém objektu, nebo lze převést na; false pro načtení pouze formátů, ve kterých jsou uložena data v tomto datovém objektu.

Návraty

String[]

Pole řetězců s každým řetězcem určujícím název formátu podporovaného tímto datovým objektem.

Implementuje

GetFormats(Boolean)

Příklady

Následující příklad používá tuto metodu k získání pole řetězců, které označují pouze datové formáty dostupné v datovém objektu (automaticky konvertibilní datové formáty jsou filtrovány).

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

Poznámky

Sadu předdefinovaných datových formátů najdete ve DataFormats třídě.