IDataObject.GetFormats Metod

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

public string[] GetFormats();

abstract member GetFormats : unit -> string[]

Public Function GetFormats () As String()

Returer

En matris med namnen som representerar en lista över alla format som stöds av de data som lagras i det här objektet.

Exempel

I det DataObject här exemplet används klassen, som implementerar IDataObject, för att demonstrera användningen av GetFormats metoden. Först skapar den ett dataobjekt (myDataObject) med hjälp av en sträng och Text formatet. Sedan hämtar den alla dataformat och datakonverteringsformat i dataobjektet och visar den resulterande listan i en meddelanderuta. Det här exemplet förutsätter att du har skapat en Form med namnet 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

Kommentarer

Anropa den här metoden för att hämta de dataformat som stöds innan du GetData anropar metoden. DataFormats Se klassen för de fördefinierade formaten.

En implementering av den här metoden finns i DataObject.GetFormats.

Se även

• GetFormats(Boolean)
• GetData(String, 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()

Parametrar

Returer

En matris med namnen som representerar en lista över alla format som stöds av de data som lagras i det här objektet.

Exempel

I det DataObject här exemplet används klassen, som implementerar IDataObject, för att demonstrera användningen av GetFormats metoden. Först skapar den ett dataobjekt (myDataObject) med hjälp av en sträng och UnicodeText formatet. Sedan görs två frågor för att hämta de format som är associerade med data. I den första frågan anger den parametern autoConvert till false : i det här fallet returneras endast det interna formatet för data. I den andra frågan anger den parametern autoConvert till true, så att den hämtar listan över format, inklusive de format som data kan konverteras till. I varje fall visas den resulterande listan i en meddelanderuta. Det här exemplet förutsätter att du har skapat en Form med namnet 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

Kommentarer

Anropa den här metoden för att hämta de dataformat som stöds innan du GetData anropar metoden. DataFormats Se klassen för de fördefinierade formaten.

En implementering av den här metoden finns i DataObject.GetFormats.

Se även

• GetFormats(Boolean)
• GetData(String, Boolean)