DataObject.GetFormats Метод

Определение

Возвращает список форматов, в которых данные хранятся в этом объекте данных или в которые их можно преобразовать.Returns a list of formats in which the data in this data object is stored, or can be converted to.

Перегрузки

GetFormats()

Возвращает список форматов, в которых данные хранятся в этом объекте данных или в которые их можно преобразовать.Returns a list of formats in which the data in this data object is stored, or can be converted to.

GetFormats(Boolean)

Возвращает список форматов, в которых данные хранятся в этом объекте данных.Returns a list of formats in which the data in this data object is stored. Флаг Boolean указывает, следует ли также включать форматы, в которые данные могут быть автоматически преобразованы.A Boolean flag indicates whether to also include formats that the data can be automatically converted to.

GetFormats()

Возвращает список форматов, в которых данные хранятся в этом объекте данных или в которые их можно преобразовать.Returns a list of formats in which the data in this data object is stored, or can be converted to.

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

Возвращаемое значение

String[]

Массив строк, каждая из которых указывает имя формата, поддерживаемого этим объектом данных.An array of strings, with each string specifying the name of a format that this data object supports.

Реализации

Примеры

В следующем примере этот метод используется для получения массива строк, обозначающих все форматы данных, доступные в объекте данных (как для собственного, так и для автоматического преобразования).The following example uses this method to get an array of strings denoting all data formats available in a data object (both native and auto-convertible).

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

Комментарии

Набор предопределенных форматов данных см. в статье о классе DataFormats.For a set of predefined data formats, see the DataFormats class.

Применяется к

GetFormats(Boolean)

Возвращает список форматов, в которых данные хранятся в этом объекте данных.Returns a list of formats in which the data in this data object is stored. Флаг Boolean указывает, следует ли также включать форматы, в которые данные могут быть автоматически преобразованы.A Boolean flag indicates whether to also include formats that the data can be automatically converted to.

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

Параметры

autoConvert
Boolean

true для извлечения всех форматов, в которых хранятся данные в этом объекте данных или могут быть в них преобразованы; false — для получения только форматов, в которых хранятся данные в этом объекте данных.true to retrieve all formats in which the data in this data object is stored, or can be converted to; false to retrieve only formats in which the data in this data object is stored.

Возвращаемое значение

String[]

Массив строк, каждая из которых задает имя формата, поддерживаемого этим объектом данных.An array of strings, with each string specifying the name of a format supported by this data object.

Реализации

Примеры

В следующем примере этот метод используется для получения массива строк, обозначающих только форматы данных, доступные в объекте данных (фильтры с автопреобразуемым форматом данных фильтруются).The following example uses this method to get an array of strings denoting only data formats available in a data object (auto-convertible data formats are filtered).

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

Комментарии

Набор предопределенных форматов данных см. в статье о классе DataFormats.For a set of predefined data formats, see the DataFormats class.

Применяется к