IDataObject.GetDataPresent Methode

Definition

Bestimmt, ob in dieser Instanz gespeicherte Daten dem angegebenen Format zugeordnet sind.

Überlädt

Name Beschreibung
GetDataPresent(String)

Bestimmt, ob in dieser Instanz gespeicherte Daten dem angegebenen Format zugeordnet oder in das angegebene Format konvertiert werden können.

GetDataPresent(Type)

Bestimmt, ob in dieser Instanz gespeicherte Daten dem angegebenen Format zugeordnet oder in das angegebene Format konvertiert werden können.

GetDataPresent(String, Boolean)

Bestimmt, ob daten, die in dieser Instanz gespeichert sind, mit einem booleschen Wert verknüpft sind, um zu bestimmen, ob die Daten in das Format konvertiert werden sollen.

GetDataPresent(String)

Quelle:
IDataObject.cs
Quelle:
IDataObject.cs
Quelle:
IDataObject.cs
Quelle:
IDataObject.cs
Quelle:
IDataObject.cs

Bestimmt, ob in dieser Instanz gespeicherte Daten dem angegebenen Format zugeordnet oder in das angegebene 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 Format, für das überprüft werden soll. Informationen zu vordefinierten Formaten finden Sie DataFormats unter

Gibt zurück

true wenn Daten, die in dieser Instanz gespeichert sind, zugeordnet sind oder in das angegebene Format konvertiert werden können; andernfalls false.

Beispiele

In diesem Beispiel wird die DataObject Klasse verwendet, die implementiert IDataObjectwird, 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 zeigt die Ergebnisse in einem Meldungsfeld an. Im Beispiel wird davon ausgegangen, dass Sie einen Form benannten 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 vor dem Aufrufen DataObjectein Format vorhanden GetData ist. Rufen Sie GetFormats die Formate auf, die in dieser Instanz verfügbar sind.

Note

Daten können in ein anderes Format konvertiert werden, wenn sie gespeichert wurde, wenn sie angegeben wurde, 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)

Quelle:
IDataObject.cs
Quelle:
IDataObject.cs
Quelle:
IDataObject.cs
Quelle:
IDataObject.cs
Quelle:
IDataObject.cs

Bestimmt, ob in dieser Instanz gespeicherte Daten dem angegebenen Format zugeordnet oder in das angegebene 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

A Type representing the format for which to check. Informationen zu vordefinierten Formaten finden Sie DataFormats unter

Gibt zurück

truewenn Daten, die in dieser Instanz gespeichert sind, zugeordnet sind oder in das angegebene Format konvertiert werden können; andernfalls . false

Beispiele

In diesem Beispiel wird die DataObject Klasse verwendet, die implementiert IDataObjectwird, 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 gespeichert myDataObjectwerden. Wenn der Test ausgewertet wird true, wird das Ergebnis in einem Meldungsfeld angezeigt und der Datentyp in einem Textfeld angezeigt. In diesem Beispiel wird davon ausgegangen, dass Sie bereits einen Form Benannten Form1 und einen TextBox Benannten 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

Rufen Sie diese Methode auf, um zu ermitteln, ob vor dem Aufrufen DataObjectein Format vorhanden GetData ist. Rufen Sie GetFormats die Formate auf, die in dieser Instanz verfügbar sind.

Note

Daten können in ein anderes Format konvertiert werden, wenn sie gespeichert wurde, wenn sie angegeben wurde, 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(String, Boolean)

Quelle:
IDataObject.cs
Quelle:
IDataObject.cs
Quelle:
IDataObject.cs
Quelle:
IDataObject.cs
Quelle:
IDataObject.cs

Bestimmt, ob daten, die in dieser Instanz gespeichert sind, mit einem booleschen Wert verknüpft sind, um zu bestimmen, 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 Format, für das überprüft werden soll. Informationen zu vordefinierten Formaten finden Sie DataFormats unter

autoConvert
Boolean

true um festzustellen, ob in dieser Instanz gespeicherte Daten in das angegebene Format konvertiert werden können; false um zu überprüfen, ob die Daten im angegebenen Format vorliegen.

Gibt zurück

truewenn sich die Daten in dem angegebenen Format befindet oder in das angegebene Format konvertiert werden können; andernfalls . false

Beispiele

In diesem Beispiel wird die DataObject Klasse verwendet, die implementiert IDataObjectwird, um die Verwendung der GetDataPresent Methode zu veranschaulichen. Zunächst wird ein Datenobjekt (myDataObject) mit einer Zeichenfolge und dem Text Format erstellt. Anschließend fragt es das Objekt nach Daten ab, die dem Text Format zugeordnet sind, wobei der autoConvert Parameter auf . false festgelegt ist. 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 true. 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 benannten 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

Rufen Sie diese Methode auf, um zu ermitteln, ob vor dem Aufrufen DataObjectein Format vorhanden GetData ist. Rufen Sie GetFormats die Formate auf, die in dieser Instanz verfügbar sind.

Diese Methode gibt Folgendes zurück true :

  • Der autoConvert Parameter ist true und die Daten in einem Format vorliegen, das in das entsprechende Format konvertiert werden kann.

  • Der autoConvert Parameter ist false und die Daten im entsprechenden Format vorliegen.

Diese Methode gibt Folgendes zurück false :

  • Der autoConvert Parameter ist true , und diese Methode kann keine Daten im angegebenen Format finden, und es können keine Daten in das angegebene Format konvertiert werden, oder die Daten wurden mit autoConvert festgelegter Eigenschaft falsegespeichert.

  • Der autoConvert Parameter ist false, und Daten sind in dieser Instanz im angegebenen Format nicht vorhanden.

Note

Daten können in ein anderes Format konvertiert werden, wenn sie gespeichert wurde, wenn sie angegeben wurde, 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: