DataObject.GetFormats Método

Definición

Devuelve una lista de los formatos en los que se almacenan los datos de este objeto de datos; o bien, a los que se pueden convertir.

Sobrecargas

GetFormats()

Devuelve una lista de los formatos en los que se almacenan los datos de este objeto de datos; o bien, a los que se pueden convertir.

GetFormats(Boolean)

Devuelve una lista de formatos en los que se almacenan los datos de este objeto de datos. Una marca Boolean indica si también se incluyen los formatos a los que los datos se convertirán automáticamente.

GetFormats()

Devuelve una lista de los formatos en los que se almacenan los datos de este objeto de datos; o bien, a los que se pueden convertir.

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

Devoluciones

String[]

Matriz de cadenas, con cada cadena que especifica el nombre de un formato que admite este objeto de datos.

Implementaciones

Ejemplos

En el ejemplo siguiente se usa este método para obtener una matriz de cadenas que denotan todos los formatos de datos disponibles en un objeto de datos (nativos y convertibles automáticamente).

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

Comentarios

Para ver un conjunto de formatos de datos predefinidos, consulte la clase DataFormats.

Se aplica a

GetFormats(Boolean)

Devuelve una lista de formatos en los que se almacenan los datos de este objeto de datos. Una marca Boolean indica si también se incluyen los formatos a los que los datos se convertirán automáticamente.

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

Es true para recuperar todos los formatos en los que se almacenan los datos de este objeto de datos o a los que se pueden convertir; es false para recuperar sólo los formatos en los que se almacenan los datos de este objeto de datos.

Devoluciones

String[]

Matriz de cadenas, en la que cada cadena especifica el nombre de un formato que admite este objeto de datos.

Implementaciones

Ejemplos

En el ejemplo siguiente se usa este método para obtener una matriz de cadenas que indica solo los formatos de datos disponibles en un objeto de datos (se filtran los formatos de datos convertibles automáticamente).

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

Comentarios

Para ver un conjunto de formatos de datos predefinidos, consulte la clase DataFormats.

Se aplica a