IDataObject.GetFormats 方法

参考

定义

命名空间:: System.Windows.Forms

程序集:: System.Windows.Forms.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

返回存储在此实例中的数据所关联的或可以转换为的所有格式的列表。

重载

GetFormats()	返回存储在此实例中的数据所关联的或可以转换为的所有格式的列表。
GetFormats(Boolean)	获取该实例中存储的数据所关联或可转换到的所有格式的列表，同时使用一个布尔值确定是检索数据可转换到的所有格式，还是只检索本机数据格式。

GetFormats()

返回存储在此实例中的数据所关联的或可以转换为的所有格式的列表。

public:
 cli::array <System::String ^> ^ GetFormats();

public string[] GetFormats ();

abstract member GetFormats : unit -> string[]

Public Function GetFormats () As String()

String[]

一组名称，表示此对象中存储的数据所支持的所有格式列表。

示例

此示例使用 DataObject 实现 IDataObject的类来演示方法的使用 GetFormats 。首先，它使用字符串和Text格式创建数据对象 (myDataObject) 。然后，它会检索数据对象中的所有数据格式和数据转换格式，并在消息框中显示结果列表。此示例假定你已创建一个 Form 命名 Form1的。

private:
   void GetFormats1()
   {
      // Creates a data object using a string and the Text format.
      DataObject^ myDataObject = gcnew DataObject( DataFormats::Text,"My text string" );
      
      // Gets all the data formats and data conversion formats in the data object.
      array<String^>^allFormats = myDataObject->GetFormats();
      
      // Creates the string that contains the formats.
      String^ theResult = "The format(s) associated with the data are: \n";
      for ( int i = 0; i < allFormats->Length; i++ )
         theResult = theResult + allFormats[ i ] + "\n";
      
      // Displays the result in a message box.
      MessageBox::Show( theResult );
   }

private void GetFormats1() 
{
    // Creates a data object using a string and the Text format.
    DataObject myDataObject = new DataObject(DataFormats.Text, "My text string");
 
    // Gets all the data formats and data conversion formats in the data object.
    String[] allFormats = myDataObject.GetFormats();

    // Creates the string that contains the formats.
    string theResult = "The format(s) associated with the data are: " + '\n';
    for(int i = 0; i < allFormats.Length; i++)
        theResult += allFormats[i] + '\n';
    // Displays the result in a message box.
    MessageBox.Show(theResult);
}

Private Sub GetFormats1()
   ' Creates a data object using a string and the Text format.
   Dim myDataObject As New DataObject(DataFormats.Text, "My text string")
   
   ' Gets all the data formats and data conversion formats in the data object.
   Dim allFormats As [String]() = myDataObject.GetFormats()
   
   ' Creates the string that contains the formats.
   Dim theResult As String = "The format(s) associated with the data are: " & _
                vbCr
   Dim i As Integer
   For i = 0 To allFormats.Length - 1
      theResult += allFormats(i) + vbCr
   Next i 
   ' Displays the result in a message box.
   MessageBox.Show(theResult)
End Sub

注解

调用此方法以在调用 GetData 该方法之前获取受支持的数据格式。 DataFormats请参阅预定义格式的类。

备注

如果数据存储指定允许转换，并且所请求的格式与存储格式兼容，则可以将数据转换为另一种格式。例如，存储为 Unicode 的数据可以转换为文本。

有关此方法的实现，请参阅 DataObject.GetFormats。

另请参阅

适用于

GetFormats(Boolean)

获取该实例中存储的数据所关联或可转换到的所有格式的列表，同时使用一个布尔值确定是检索数据可转换到的所有格式，还是只检索本机数据格式。

public:
 cli::array <System::String ^> ^ GetFormats(bool autoConvert);

public string[] GetFormats (bool autoConvert);

abstract member GetFormats : bool -> string[]

Public Function GetFormats (autoConvert As Boolean) As String()

参数

autoConvert: Boolean

值为 true 时，检索存储在此实例中的数据所关联的或可以转换成的所有格式；值为 false 时，仅检索本机数据格式。

String[]

一组名称，表示此对象中存储的数据所支持的所有格式列表。

示例

此示例使用 DataObject 实现 IDataObject的类来演示方法的使用 GetFormats 。首先，它使用字符串和UnicodeText格式创建数据对象 (myDataObject) 。然后，它发出两个查询来获取与数据关联的格式。在第一个查询中，它将参数设置为 autoConvert false ：在这种情况下，仅返回数据的本机格式。在第二个查询中，它将参数true设置为 autoConvert ，以便获取格式列表，包括数据可转换为的格式。在每种情况下，生成的列表将显示在消息框中。此示例假定你已创建一个 Form 命名 Form1的。

private:
   void GetFormats2()
   {
      // Creates a new data object using a string and the UnicodeText format.
      DataObject^ myDataObject = gcnew DataObject( DataFormats::UnicodeText,"My text string" );
      
      // Gets the original data formats in the data object by setting the automatic
      // conversion parameter to false.
      array<String^>^myFormatsArray = myDataObject->GetFormats( false );
      
      // Stores the results in a string.
      String^ theResult = "The original format associated with the data is:\n";
      for ( int i = 0; i < myFormatsArray->Length; i++ )
         theResult = theResult + myFormatsArray[ i ] + "\n";
      
      // Gets all data formats and data conversion formats for the data object.
      myFormatsArray = myDataObject->GetFormats( true );
      
      // Stores the results in the string.
      theResult = theResult + "\nThe data format(s) and conversion format(s) associated with the data are:\n";
      for ( int i = 0; i < myFormatsArray->Length; i++ )
         theResult = theResult + myFormatsArray[ i ] + "\n";
      
      // Displays the results.
      MessageBox::Show( theResult );
   }

private void GetFormats2() 
{
    // Creates a new data object using a string and the UnicodeText format.
    DataObject myDataObject = new DataObject(DataFormats.UnicodeText, "My text string");

    // Gets the original data formats in the data object by setting the automatic
    // conversion parameter to false.
    String[] myFormatsArray = myDataObject.GetFormats(false);

    // Stores the results in a string.
    string theResult = "The original format associated with the data is:\n";
    for(int i = 0; i < myFormatsArray.Length; i++)
        theResult += myFormatsArray[i] + '\n';

    // Gets all data formats and data conversion formats for the data object.
    myFormatsArray = myDataObject.GetFormats(true);
 
    // Stores the results in the string.
    theResult += "\nThe data format(s) and conversion format(s) associated with " +
        "the data are:\n";
    for(int i = 0; i < myFormatsArray.Length; i++)
        theResult += myFormatsArray[i] + '\n';

    // Displays the results.
    MessageBox.Show(theResult);
}

Private Sub GetFormats2()
   ' Creates a new data object using a string and the UnicodeText format.
   Dim myDataObject As New DataObject(DataFormats.UnicodeText, "My text string")
   
   ' Gets the original data formats in the data object by setting the automatic
   ' conversion parameter to false.
   Dim myFormatsArray As [String]() = myDataObject.GetFormats(False)
   
   ' Stores the results in a string.
   Dim theResult As String = "The original format associated with the data is:" & vbCr
   Dim i As Integer
   For i = 0 To myFormatsArray.Length - 1
      theResult += myFormatsArray(i) + vbCr
   Next i 
   ' Gets all data formats and data conversion formats for the data object.
   myFormatsArray = myDataObject.GetFormats(True)
   
   ' Stores the results in the string.
   theResult += vbCr + "The data format(s) and conversion format(s) associated with " & _
     "the data are:" & vbCr
   For i = 0 To myFormatsArray.Length - 1
      theResult += myFormatsArray(i) + vbCr
   Next i
   ' Displays the results.
   MessageBox.Show(theResult)
End Sub

注解

调用此方法以在调用 GetData 该方法之前获取受支持的数据格式。 DataFormats请参阅预定义格式的类。

备注

如果数据存储指定允许转换，并且所请求的格式与存储格式兼容，则可以将数据转换为另一种格式。例如，存储为 Unicode 的数据可以转换为文本。

有关此方法的实现，请参阅 DataObject.GetFormats。

另请参阅

适用于

通过

IDataObject.GetFormats 方法

定义

重载

GetFormats()

返回

示例

注解

另请参阅

适用于

GetFormats(Boolean)

参数

返回

示例

注解

另请参阅

适用于

其他资源