DataObject.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 daten, die in diesem DataObject gespeichert sind, dem angegebenen Format zugeordnet sind.

Überlädt

GetDataPresent(String)	Bestimmt, ob in diesem DataObject gespeicherte Daten dem angegebenen Format zugeordnet oder in das angegebene Format konvertiert werden können.
GetDataPresent(Type)	Bestimmt, ob in diesem DataObject gespeicherte Daten dem angegebenen Format zugeordnet oder in das angegebene Format konvertiert werden können.
GetDataPresent(String, Boolean)	Bestimmt, ob diese DataObject Daten im angegebenen Format enthält oder optional Daten enthält, die in das angegebene Format konvertiert werden können.

GetDataPresent(String)

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

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

public virtual bool GetDataPresent (string format);

abstract member GetDataPresent : string -> bool
override this.GetDataPresent : string -> bool

Public Overridable Function GetDataPresent (format As String) As Boolean

Parameter

format: String

Das zu überprüfende Format. Informationen zu vordefinierten Formaten finden Sie unter DataFormats.

Gibt zurück

Boolean

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

Implementiert

GetDataPresent(String)

Beispiele

Im folgenden Codebeispiel wird ermittelt, ob daten, die derzeit in diesem DataObject gespeichert sind, zugeordnet sind oder in ein angegebenes Format konvertiert werden können. Eine neue DataObject wird mit einer Zeichenfolge und dem zugehörigen Format initialisiert, das als Text angegeben ist.

Anschließend werden in den Beispielen gedruckt, ob Textdaten im DataObjectvorhanden sind. Dieser Code erfordert, dass textBox1 erstellt wurde.

Hinweise

Rufen Sie diese Methode auf, um zu bestimmen, ob ein Format vorhanden ist, bevor GetDataaufgerufen wird. Rufen Sie GetFormats für die Formate auf, die in diesem DataObjectverfügbar sind.

Anmerkung

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.

Anmerkung

Wenn keine Daten abgerufen werden können, wird keine Ausnahme ausgelöst. Stattdessen wird false zurückgegeben.

Weitere Informationen

Gilt für:

GetDataPresent(Type)

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

public:
 virtual bool GetDataPresent(Type ^ format);

public virtual bool GetDataPresent (Type format);

abstract member GetDataPresent : Type -> bool
override this.GetDataPresent : Type -> bool

Public Overridable Function GetDataPresent (format As Type) As Boolean

Parameter

format: Type

Ein Type, der das zu überprüfende Format darstellt.

Gibt zurück

Boolean

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

Implementiert

GetDataPresent(Type)

Beispiele

Im folgenden Codebeispiel wird ermittelt, ob Daten des angegebenen Typs in einem DataObjectvorhanden sind oder ob die Daten in den angegebenen Typ konvertiert werden können. Das Ergebnis wird in einem Textfeld angezeigt. Der Code erfordert, dass textBox1 erstellt wurde.

private:
   void GetIfPresent2()
   {
      // 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();
      
      // Determines if the DataObject has data of the Type format.
      textBox1->Text = String::Concat( "Is the specified data type available ",
         "in the DataObject? ", myDataObject->GetDataPresent( myType ), "\n" );
      
      // Retrieves the data using its type format, and displays the type.
      Object^ myObject = myDataObject->GetData( myType );
      textBox1->Text = String::Concat( textBox1->Text, "The data type stored ",
         "in the DataObject is: ", myObject->GetType()->Name );
   }

private void GetIfPresent2() {
    // 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();
 
    // Determines if the DataObject has data of the Type format.
    textBox1.Text = "Is the specified data type available in the " +
       "DataObject? " + myDataObject.GetDataPresent(myType).ToString() + '\n';
 
    // Retrieves the data using its type format, and displays the type.
    Object myObject = myDataObject.GetData(myType);
    textBox1.Text += "The data type stored in the DataObject is: " +
       myObject.GetType().Name;
 }

Private Sub GetIfPresent2()
    ' Creates a component to store in the data object.
    Dim myComponent As New 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()
    
    ' Determines if the DataObject has data of the Type format.
    textBox1.Text = "Is the specified data type available in the " & "DataObject? " & _
        myDataObject.GetDataPresent(myType).ToString() & ControlChars.Cr
    
    ' Retrieves the data using its type format, and displays the type.
    Dim myObject As Object = myDataObject.GetData(myType)
    textBox1.Text += "The data type stored in the DataObject is: " + myObject.GetType().Name
End Sub

Hinweise

Rufen Sie diese Methode auf, um zu bestimmen, ob ein Format vorhanden ist, bevor GetDataaufgerufen wird. Rufen Sie GetFormats für die Formate auf, die in diesem DataObjectverfügbar sind.

Anmerkung

Wenn keine Daten abgerufen werden können, wird keine Ausnahme ausgelöst. Stattdessen wird false zurückgegeben.

Weitere Informationen

Gilt für:

GetDataPresent(String, Boolean)

Bestimmt, ob diese DataObject Daten im angegebenen Format enthält oder optional Daten enthält, die in das angegebene Format konvertiert werden können.

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

public virtual bool GetDataPresent (string format, bool autoConvert);

abstract member GetDataPresent : string * bool -> bool
override this.GetDataPresent : string * bool -> bool

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

Parameter

format: String

Das zu überprüfende Format. Informationen zu vordefinierten Formaten finden Sie unter DataFormats.

autoConvert: Boolean

true zu bestimmen, ob in diesem DataObject gespeicherte Daten in das angegebene Format konvertiert werden können; false, um zu überprüfen, ob sich die Daten im angegebenen Format befindet.

Gibt zurück

Boolean

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

Implementiert

GetDataPresent(String, Boolean)

Beispiele

Im folgenden Codebeispiel wird ermittelt, ob daten, die derzeit im DataObject gespeichert sind, einem angegebenen Format zugeordnet sind. Zunächst wird eine neue DataObject mit einer Zeichenfolge initialisiert, die das Format als Text angibt.

Anschließend wird die DataObject nach Daten abgefragt, die dem Textformat zugeordnet sind, wobei der parameter autoConvert als falseangegeben wird. Das Ergebnis dieser Abfrage wird in einem Textfeld gedruckt.

Anschließend wird die DataObject nach Daten abgefragt, die dem Zeichenfolgenformat zugeordnet sind, und den parameter autoConvert als trueangeben. Die Ergebnisse werden im Textfeld gedruckt. Dieser Code erfordert, dass textBox1 erstellt wurde.

private:
   void GetIfPresent3()
   {
      // Creates a new data object using a string and the text format.
      DataObject^ myDataObject = gcnew DataObject( DataFormats::Text, "Another string" );
      
      // Prints the string in a text box with autoconvert = false.
      if ( myDataObject->GetDataPresent( "System.String", false ) )
      {
         // Prints the string in a text box.
         textBox1->Text = String::Concat(
            myDataObject->GetData( "System.String", false )->ToString(), "\n" );
      }
      else
      {
         textBox1->Text = "Could not convert data to specified format\n";
      }
      
      // Prints the string in a text box with autoconvert = true.
      textBox1->Text = String::Concat( textBox1->Text,
         "With autoconvert = true, you can convert text to string format. String is: ",
         myDataObject->GetData( "System.String", true )->ToString() );
   }

private void GetIfPresent3() {
    // Creates a new data object using a string and the text format.
    DataObject myDataObject = new DataObject(DataFormats.Text, "Another string");
 
    // Prints the string in a text box with autoconvert = false.
    if(myDataObject.GetDataPresent("System.String", false)) {
       // Prints the string in a text box.
       textBox1.Text = myDataObject.GetData("System.String", false).ToString() + '\n';
    } else
        {
            textBox1.Text = "Could not convert data to specified format" + '\n';
        }

        // Prints the string in a text box with autoconvert = true.
        textBox1.Text += "With autoconvert = true, you can convert text to string format. " +
       "String is: " + myDataObject.GetData("System.String", true).ToString();
 }

Private Sub GetIfPresent3()
    ' Creates a new data object using a string and the text format.
    Dim myDataObject As New DataObject(DataFormats.Text, "Another string")
    
    ' Prints the string in a text box with autoconvert = false.
    If myDataObject.GetDataPresent("System.String", False) Then
        ' Prints the string in a text box.
        textBox1.Text = myDataObject.GetData("System.String", False).ToString() & ControlChars.Cr
    Else
        textBox1.Text = "Could not convert data to specified format" & ControlChars.Cr
    End If 
    ' Prints the string in a text box with autoconvert = true.
    textBox1.Text &= "With autoconvert = true, you can convert text to string format. " & _
                    "String is: " & myDataObject.GetData("System.String", True).ToString()
End Sub

Hinweise

Rufen Sie diese Methode auf, um zu bestimmen, ob ein Format vorhanden ist, bevor GetDataaufgerufen wird. Rufen Sie GetFormats für die Formate auf, die in diesem DataObjectverfügbar sind.

Diese Methode gibt true zurück, wenn:

Der parameter autoConvert ist true und die Daten in einem Format, das in das entsprechende Format konvertiert werden kann.
Der parameter autoConvert ist false und die Daten sind im entsprechenden Format.

Diese Methode gibt false zurück, wenn:

Der parameter autoConvert 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 automatischer Konvertierung auf falsegespeichert.
Der parameter autoConvert ist false und daten sind in diesem DataObject im angegebenen Format nicht vorhanden.

Anmerkung

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

Anmerkung

Wenn keine Daten abgerufen werden können, wird keine Ausnahme ausgelöst. Stattdessen wird false zurückgegeben.

Weitere Informationen

Gilt für:

Freigeben über

DataObject.GetDataPresent Methode

Definition

Überlädt

GetDataPresent(String)

Parameter

Gibt zurück

Implementiert

Beispiele

Hinweise

Weitere Informationen

Gilt für:

GetDataPresent(Type)

Parameter

Gibt zurück

Implementiert

Beispiele

Hinweise

Weitere Informationen

Gilt für:

GetDataPresent(String, Boolean)

Parameter

Gibt zurück

Implementiert

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Zusätzliche Ressourcen