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 den in diesem DataObject gespeicherten Daten das angegebene Format zugewiesen ist.

Überlädt

GetDataPresent(String)	Bestimmt, ob den in diesem DataObject gespeicherten Daten das angegebene Format zugewiesen ist bzw. diese in das Format konvertiert werden können.
GetDataPresent(Type)	Bestimmt, ob den in diesem DataObject gespeicherten Daten das angegebene Format zugewiesen ist bzw. diese in das Format konvertiert werden können.
GetDataPresent(String, Boolean)	Bestimmt, ob dieses DataObject Daten im angegebenen Format enthält oder Daten, die in das angegebene Format konvertiert werden können (optional).

GetDataPresent(String)

Bestimmt, ob den in diesem DataObject gespeicherten Daten das angegebene Format zugewiesen ist bzw. diese in das 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 Format, das gesucht werden soll. Vordefinierte Formate finden Sie unter DataFormats.

Gibt zurück

Boolean

true, wenn den in diesem DataObject gespeicherten Daten das angegebene Format zugewiesen ist bzw. diese in das Format konvertiert werden können, andernfalls false.

Implementiert

GetDataPresent(String)

Beispiele

Im folgenden Codebeispiel wird bestimmt, ob die derzeit in diesem DataObject gespeicherten Daten einem angegebenen Format zugeordnet sind oder in dieses konvertiert werden können. Eine neue DataObject wird mit einer Zeichenfolge und dem zugehörigen Format initialisiert, das als Text angegeben ist.

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

Hinweise

Rufen Sie diese Methode auf, um zu ermitteln, ob ein Format vorhanden ist, bevor Sie aufrufen GetData. Rufen Sie GetFormats die Formate auf, die in diesem DataObjectverfü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.

Hinweis

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

Weitere Informationen

Gilt für:

GetDataPresent(Type)

Bestimmt, ob den in diesem DataObject gespeicherten Daten das angegebene Format zugewiesen ist bzw. diese in das 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, das das gesuchte Format darstellt.

Gibt zurück

Boolean

true, wenn den in diesem DataObject gespeicherten Daten das angegebene Format zugewiesen ist bzw. diese in das Format konvertiert werden können, andernfalls false.

Implementiert

GetDataPresent(Type)

Beispiele

Im folgenden Codebeispiel wird bestimmt, 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 ermitteln, ob ein Format vorhanden ist, bevor Sie aufrufen GetData. Rufen Sie GetFormats die Formate auf, die in diesem DataObjectverfügbar sind.

Hinweis

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

Weitere Informationen

Gilt für:

GetDataPresent(String, Boolean)

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

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 Format, das gesucht werden soll. Vordefinierte Formate finden Sie unter DataFormats.

autoConvert: Boolean

true, um zu bestimmen, ob die in diesem DataObject 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.

Implementiert

GetDataPresent(String, Boolean)

Beispiele

Im folgenden Codebeispiel wird bestimmt, ob derzeit gespeicherte DataObject Daten einem angegebenen Format zugeordnet sind. Zunächst wird eine neue DataObject mit einer Zeichenfolge initialisiert, wobei ihr Format als Text angegeben wird.

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

Anschließend wird nach Daten abgefragt, die DataObject dem Zeichenfolgenformat zugeordnet sind, wobei der autoConvert Parameter als trueangegeben wird. 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 ermitteln, ob ein Format vorhanden ist, bevor Sie aufrufen GetData. Rufen Sie GetFormats die Formate auf, die in diesem DataObjectverfügbar sind.

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 der automatischen Konvertierung falseauf gespeichert.
Der autoConvert Parameter ist false , und die Daten sind in diesem DataObject Format nicht vorhanden.

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.

Hinweis

Wenn keine Daten abgerufen werden können, wird keine Ausnahme ausgelöst. Stattdessen false wird 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