Partilhar via


DataObject.GetFormats Método

Definição

Retorna uma lista de formatos em que os dados neste objeto de dados estão armazenados ou nos quais eles podem ser convertidos.

Sobrecargas

GetFormats()

Retorna uma lista de formatos em que os dados neste objeto de dados estão armazenados ou nos quais eles podem ser convertidos.

GetFormats(Boolean)

Retorna uma lista de formatos em que os dados neste objeto de dados estão armazenados. Um sinalizador Boolean indica se os formatos nos quais os dados podem ser automaticamente convertidos devem ser incluídos.

GetFormats()

Retorna uma lista de formatos em que os dados neste objeto de dados estão armazenados ou nos quais eles podem ser convertidos.

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

Retornos

String[]

Uma matriz de cadeias de caracteres, com cada cadeia de caracteres especificando o nome de um formato compatível com este objeto de dados.

Implementações

Exemplos

O exemplo a seguir usa esse método para obter uma matriz de cadeias de caracteres indicando todos os formatos de dados disponíveis em um objeto de dados (nativo e conversível automático).

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

Comentários

Para um conjunto de formatos de dados predefinidos, consulte a classe DataFormats.

Aplica-se a

GetFormats(Boolean)

Retorna uma lista de formatos em que os dados neste objeto de dados estão armazenados. Um sinalizador Boolean indica se os formatos nos quais os dados podem ser automaticamente convertidos devem ser incluídos.

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

Parâmetros

autoConvert
Boolean

true para recuperar todos os formatos em que os dados neste objeto de dados estão armazenados ou para os quais podem ser convertidos; false para recuperar apenas os formatos em que os dados neste objeto de dados são armazenados.

Retornos

String[]

Uma matriz de cadeias de caracteres, com cada cadeia de caracteres especificando o nome de um formato compatível com este objeto de dados.

Implementações

Exemplos

O exemplo a seguir usa esse método para obter uma matriz de cadeias de caracteres indicando apenas formatos de dados disponíveis em um objeto de dados (formatos de dados conversíveis automáticos são filtrados).

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

Comentários

Para um conjunto de formatos de dados predefinidos, consulte a classe DataFormats.

Aplica-se a