IDataObject.GetDataPresent Methode

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bestimmt, ob den in dieser Instanz gespeicherten Daten das angegebene Format zugewiesen ist.

Überlädt

GetDataPresent(String)	Bestimmt, ob den in dieser Instanz gespeicherten Daten das angegebene Format zugewiesen ist bzw. sie in das Format konvertiert werden können.
GetDataPresent(Type)	Bestimmt, ob den in dieser Instanz gespeicherten Daten das angegebene Format zugewiesen ist bzw. sie in das Format konvertiert werden können.
GetDataPresent(String, Boolean)	Bestimmt, ob den in dieser Instanz gespeicherten Daten das angegebene Format zugewiesen ist. Ein boolescher Wert legt dabei fest, ob die Daten in das Format konvertiert werden sollen.

GetDataPresent(String)

Bestimmt, ob den in dieser Instanz gespeicherten Daten das angegebene Format zugewiesen ist bzw. sie in das Format konvertiert werden können.

public:
 bool GetDataPresent(System::String ^ format);

public bool GetDataPresent (string format);

abstract member GetDataPresent : string -> bool

Public Function GetDataPresent (format As String) As Boolean

Parameter

format: String

Das zu suchende Format. Vordefinierte Formate finden Sie unter DataFormats.

Gibt zurück

Boolean

true, wenn den in dieser Instanz gespeicherten Daten das angegebene Format zugeordnet ist oder sie in dieses Format konvertiert werden können, andernfalls false.

Beispiele

In diesem Beispiel wird die DataObject -Klasse verwendet, die implementiert IDataObject, um die Verwendung der GetDataPresent -Methode zu veranschaulichen. Zunächst wird ein Datenobjekt mit einer Zeichenfolge und dem Text Format erstellt. Anschließend wird überprüft, ob die Daten im Text Format vorhanden sind, und die Ergebnisse werden in einem Meldungsfeld angezeigt. Im Beispiel wird davon ausgegangen, dass Sie einen Form mit dem Namen Form1erstellt haben.

private:
   void TestDataObject()
   {
      // Creates a new data object using a string and the Text format.
      String^ myString = "Hello World!";
      DataObject^ myDataObject = gcnew DataObject( DataFormats::Text,myString );

      // Checks whether the data is present in the Text format and displays the result.
      if ( myDataObject->GetDataPresent( DataFormats::Text ) )
            MessageBox::Show( "The stored data is in the Text format.", "Test Result" );
      else
            MessageBox::Show( "The stored data is not in the Text format.", "Test Result" );
   }

       private void TestDataObject() 
       {
           // Creates a new data object using a string and the Text format.
           string myString = "Hello World!";
           DataObject myDataObject = new DataObject(DataFormats.Text, myString);

           // Checks whether the data is present in the Text format and displays the result.
           if (myDataObject.GetDataPresent(DataFormats.Text))
               MessageBox.Show("The stored data is in the Text format." , "Test Result");
           else
               MessageBox.Show("The stored data is not in the Text format.", "Test Result");
       }

Private Sub TestDataObject()
    ' Creates a new data object using a string and the Text format.
    Dim myString As New String("Hello World!")
    Dim myDataObject As New DataObject(DataFormats.Text, myString)

    ' Checks whether the data is present in the Text format and displays the result.
    If (myDataObject.GetDataPresent(DataFormats.Text)) Then
        MessageBox.Show("The stored data is in the Text format.", "Test Result")
    Else
        MessageBox.Show("The stored data is not in the Text format.", "Test Result")
    End If
End Sub

Hinweise

Rufen Sie diese Methode auf, um zu ermitteln, ob ein Format in diesem DataObject vorhanden ist, bevor Sie aufrufen GetData. Rufen Sie GetFormats die Formate auf, die in dieser Instanz verfügbar sind.

Hinweis

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

Eine Implementierung dieser Methode finden Sie unter DataObject.GetDataPresent.

Weitere Informationen

Gilt für:

GetDataPresent(Type)

Bestimmt, ob den in dieser Instanz gespeicherten Daten das angegebene Format zugewiesen ist bzw. sie in das Format konvertiert werden können.

public:
 bool GetDataPresent(Type ^ format);

public bool GetDataPresent (Type format);

abstract member GetDataPresent : Type -> bool

Public Function GetDataPresent (format As Type) As Boolean

Parameter

format: Type

Type stellt das Format dar, das gesucht werden soll. Vordefinierte Formate finden Sie unter DataFormats.

Gibt zurück

Boolean

true, wenn den in dieser Instanz gespeicherten Daten das angegebene Format zugewiesen ist bzw. sie in das Format konvertiert werden können, andernfalls false.

Beispiele

In diesem Beispiel wird die DataObject -Klasse verwendet, die implementiert IDataObject, um die Verwendung der GetDataPresent -Methode zu veranschaulichen. Zunächst wird eine Komponente (myComponent) erstellt und in einem Datenobjekt (myDataObject) gespeichert. Anschließend wird überprüft, ob die angegebenen Daten in myDataObjectgespeichert sind. Wenn der Test ausgewertet truewird, wird das Ergebnis in einem Meldungsfeld und der Datentyp in einem Textfeld angezeigt. In diesem Beispiel wird davon ausgegangen, dass Sie bereits einen Form benannten Form1 und einen TextBox mit dem Namen textBox1erstellt haben.

private:
   void GetDataPresent2()
   {
      // Creates a component to store in the data object.
      Component^ myComponent = gcnew Component;

      // Creates a new data object and assigns it the component.
      DataObject^ myDataObject = gcnew DataObject( myComponent );

      // Creates a type to store the type of data.
      Type^ myType = myComponent->GetType();

      // Checks whether the specified data type exists in the object.
      if ( myDataObject->GetDataPresent( myType ) )
      {
         MessageBox::Show( "The specified data is stored in the data object." );

         // Displays the type of data.
         textBox1->Text = "The data type is " + myDataObject->GetData( myType )->GetType()->Name + ".";
      }
      else
            MessageBox::Show( "The specified data is not stored in the data object." );
   }

       private void GetDataPresent2() 
       {
           // Creates a component to store in the data object.
           Component myComponent = new Component();

           // Creates a new data object and assigns it the component.
           DataObject myDataObject = new DataObject(myComponent);

           // Creates a type to store the type of data.
           Type myType = myComponent.GetType();

           // Checks whether the specified data type exists in the object.
           if (myDataObject.GetDataPresent(myType))
           {
               MessageBox.Show("The specified data is stored in the data object.");
               // Displays the type of data.
               textBox1.Text = "The data type is " + myDataObject.GetData(myType).GetType().Name + ".";
           }
           else
           {
               MessageBox.Show("The specified data is not stored in the data object.");
           }
       }

Private Sub GetDataPresent2()
    ' Creates a component to store in the data object.
    Dim myComponent As New System.ComponentModel.Component()

    ' Creates a new data object and assigns it the component.
    Dim myDataObject As New DataObject(myComponent)

    'Creates a type to store the type of data.
    Dim myType As Type = myComponent.GetType()

    ' Checks whether the specified data type exists in the object.
    If myDataObject.GetDataPresent(myType) Then
        MessageBox.Show("The specified data is stored in the data object.")
        ' Displays the type of data.
        TextBox1.Text = "The data type is " & myDataObject.GetData(myType).GetType().Name & "."
    Else
        MessageBox.Show("The specified data is not stored in the data object.")
    End If
End Sub

Hinweise

Hinweis

Eine Implementierung dieser Methode finden Sie unter DataObject.GetDataPresent.

Weitere Informationen

Gilt für:

GetDataPresent(String, Boolean)

Bestimmt, ob den in dieser Instanz gespeicherten Daten das angegebene Format zugewiesen ist. Ein boolescher Wert legt dabei fest, ob die Daten in das Format konvertiert werden sollen.

public:
 bool GetDataPresent(System::String ^ format, bool autoConvert);

public bool GetDataPresent (string format, bool autoConvert);

abstract member GetDataPresent : string * bool -> bool

Public Function GetDataPresent (format As String, autoConvert As Boolean) As Boolean

Parameter

format: String

Das zu suchende Format. Vordefinierte Formate finden Sie unter DataFormats.

autoConvert: Boolean

true, um zu bestimmen, ob die in dieser Instanz gespeicherten Daten in das angegebene Format konvertiert werden können, false, um zu prüfen, ob die Daten im angegebenen Format vorliegen.

Gibt zurück

Boolean

true, wenn die Daten das angegebene Format aufweisen oder in dieses konvertiert werden können, andernfalls false.

Beispiele

In diesem Beispiel wird die DataObject -Klasse verwendet, die implementiert IDataObject, um die Verwendung der GetDataPresent -Methode zu veranschaulichen. Zunächst wird ein Datenobjekt (myDataObject) mithilfe einer Zeichenfolge und des Text Formats erstellt. Anschließend fragt es das Objekt nach Daten ab, die dem Text Format zugeordnet sind, wobei der autoConvert Parameter auf festgelegt ist false. Diese Testversion schlägt fehl, und das Ergebnis wird in einem Meldungsfeld mit der Bezeichnung "Nachricht #1" angezeigt. In der zweiten Testversion wird der autoConvert Parameter auf truefestgelegt. Diese Testversion ist erfolgreich, und das Ergebnis wird in einem Meldungsfeld mit der Bezeichnung "Nachricht #2" angezeigt. Im Beispiel wird davon ausgegangen, dass Sie einen Form mit dem Namen Form1erstellt haben.

private:
   void GetDataPresent3()
   {
      // Creates a new data object using a string and the Text format.
      DataObject^ myDataObject = gcnew DataObject( DataFormats::Text,"My String" );

      // Checks whether the string can be displayed with autoConvert equal to false.
      if ( myDataObject->GetDataPresent( "System::String", false ) )
            MessageBox::Show( myDataObject->GetData( "System::String", false )->ToString(), "Message #1" );
      else
            MessageBox::Show( "Cannot convert data to the specified format with autoConvert set to false.", "Message #1" );

      // Displays the string with autoConvert equal to true.
      MessageBox::Show( "Now that autoConvert is true, you can convert " + myDataObject->GetData( "System::String", true ) + " to string format.", "Message #2" );
   }

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

           // Checks whether the string can be displayed with autoConvert equal to false.
           if(myDataObject.GetDataPresent("System.String", false)) 
               MessageBox.Show(myDataObject.GetData("System.String", false).ToString(), "Message #1");
           else
               MessageBox.Show("Cannot convert data to the specified format with autoConvert set to false.", "Message #1");

           // Displays the string with autoConvert equal to true.
           MessageBox.Show("Now that autoConvert is true, you can convert " + 
               myDataObject.GetData("System.String", true).ToString() + " to string format.","Message #2");
       }

Private Sub GetDataPresent3()
    ' Creates a new data object using a string and the Text format.
    Dim myDataObject As New DataObject(DataFormats.Text, "My String")

    ' Checks whether the string can be displayed with autoConvert equal to false.
    If myDataObject.GetDataPresent("System.String", False) Then
        MessageBox.Show(myDataObject.GetData("System.String", False).ToString() + ".", "Message #1")
    Else
        MessageBox.Show("Cannot convert data to the specified format with autoConvert set to false.", "Message #1")
    End If
    ' Displays the string with autoConvert equal to true.
    MessageBox.Show(("Now that autoConvert is true, you can convert " + myDataObject.GetData("System.String", _
         True).ToString() + " to string format."), "Message #2")

End Sub

Hinweise

Diese Methode gibt zurück true , wenn:

Der autoConvert Parameter ist true , und die Daten haben ein Format, das in das entsprechende Format konvertiert werden kann.
Der autoConvert Parameter ist false , und die Daten haben das entsprechende Format.

Diese Methode gibt zurück false , wenn:

Der autoConvert Parameter ist true , und diese Methode kann keine Daten im angegebenen Format finden und kann keine Daten in das angegebene Format konvertieren, oder die Daten wurden mit autoConvert festgelegt auf falsegespeichert.
Der autoConvert Parameter ist false, und die Daten sind in dieser Instanz nicht im angegebenen Format vorhanden.

Hinweis

Eine Implementierung dieser Methode finden Sie unter DataObject.GetDataPresent.

Weitere Informationen

Gilt für:

IDataObject.GetDataPresent Methode

Definition

Überlädt

GetDataPresent(String)

Parameter

Gibt zurück

Beispiele

Hinweise

Weitere Informationen

Gilt für:

GetDataPresent(Type)

Parameter

Gibt zurück

Beispiele

Hinweise

Weitere Informationen

Gilt für:

GetDataPresent(String, Boolean)

Parameter

Gibt zurück

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Feedback

Zusätzliche Ressourcen