Freigeben über

IDataObject.GetFormats Methode

  • Referenz

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Gibt eine Liste aller Formate zurück, die den in dieser Instanz gespeicherten Daten zugeordnet sind oder in die diese Daten konvertiert werden können.

Überlädt

GetFormats()

Gibt eine Liste aller Formate zurück, die den in dieser Instanz gespeicherten Daten zugeordnet sind oder in die diese Daten konvertiert werden können.
GetFormats(Boolean)

Ruft eine Liste aller Formate ab, denen die in dieser Instanz gespeicherten Daten zugeordnet sind oder in die diese Daten konvertiert werden können. Dabei wird über einen booleschen Wert angegeben, ob auch Formate, in die die Daten konvertiert werden können, oder nur systemeigene Datenformate abgerufen werden sollen.

GetFormats()

Gibt eine Liste aller Formate zurück, die den in dieser Instanz gespeicherten Daten zugeordnet sind oder in die diese Daten konvertiert werden können.

public:
 cli::array <System::String ^> ^ GetFormats();
public string[] GetFormats ();
abstract member GetFormats : unit -> string[]
Public Function GetFormats () As String()

Gibt zurück

String[]

Ein Array mit Namen, das eine Liste aller Formate darstellt, die von den in diesem Objekt gespeicherten Daten unterstützt werden.

Beispiele

In diesem Beispiel wird die DataObject Klasse verwendet, die IDataObjectimplementiert wird, um die Verwendung der GetFormats Methode zu veranschaulichen. Zunächst wird ein Datenobjekt (myDataObject) mithilfe einer Zeichenfolge und des Text Formats erstellt. Anschließend ruft er alle Datenformate und Datenkonvertierungsformate im Datenobjekt ab und zeigt die resultierende Liste in einem Meldungsfeld an. In diesem Beispiel wird davon ausgegangen, dass Sie einen Form benannten Namen Form1erstellt haben.

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

Hinweise

Rufen Sie diese Methode auf, um die unterstützten Datenformate abzurufen, bevor Sie die GetData Methode aufrufen. Sehen Sie sich die DataFormats Klasse für die vordefinierten Formate an.

Hinweis

Daten können in ein anderes Format konvertiert werden, wenn sie gespeichert wurde, um anzugeben, dass die Konvertierung zulässig ist, und wenn das angeforderte Format mit dem gespeicherten Format kompatibel ist. Daten, die als Unicode gespeichert sind, können beispielsweise in Text konvertiert werden.

Eine Implementierung dieser Methode finden Sie unter DataObject.GetFormats.

Siehe auch

Gilt für

GetFormats(Boolean)

Ruft eine Liste aller Formate ab, denen die in dieser Instanz gespeicherten Daten zugeordnet sind oder in die diese Daten konvertiert werden können. Dabei wird über einen booleschen Wert angegeben, ob auch Formate, in die die Daten konvertiert werden können, oder nur systemeigene Datenformate abgerufen werden sollen.

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

Parameter

autoConvert
Boolean

true, wenn alle Formate abgerufen werden sollen, die den in dieser Instanz gespeicherten Daten zugeordnet sind bzw. in die diese konvertiert werden können, false, wenn nur systemeigene Datenformate abgerufen werden sollen.

Gibt zurück

String[]

Ein Array mit Namen, das eine Liste aller Formate darstellt, die von den in diesem Objekt gespeicherten Daten unterstützt werden.

Beispiele

In diesem Beispiel wird die DataObject Klasse verwendet, die IDataObjectimplementiert wird, um die Verwendung der GetFormats Methode zu veranschaulichen. Zunächst wird ein Datenobjekt (myDataObject) mithilfe einer Zeichenfolge und des UnicodeText Formats erstellt. Anschließend werden zwei Abfragen erstellt, um die mit den Daten verknüpften Formate abzurufen. In der ersten Abfrage wird der autoConvert Parameter auf false : in diesem Fall wird nur das systemeigene Format der Daten zurückgegeben. In der zweiten Abfrage wird der autoConvert Parameter so truefestgelegt, dass er die Liste der Formate abruft, einschließlich der Formate, in die die Daten konvertiert werden können. In jedem Fall wird die resultierende Liste in einem Meldungsfeld angezeigt. In diesem Beispiel wird davon ausgegangen, dass Sie einen Form benannten Namen Form1erstellt haben.

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

Hinweise

Rufen Sie diese Methode auf, um die unterstützten Datenformate abzurufen, bevor Sie die GetData Methode aufrufen. Sehen Sie sich die DataFormats Klasse für die vordefinierten Formate an.

Hinweis

Daten können in ein anderes Format konvertiert werden, wenn sie gespeichert wurde, um anzugeben, dass die Konvertierung zulässig ist, und wenn das angeforderte Format mit dem gespeicherten Format kompatibel ist. Daten, die als Unicode gespeichert sind, können beispielsweise in Text konvertiert werden.

Eine Implementierung dieser Methode finden Sie unter DataObject.GetFormats.

Siehe auch

Gilt für