DataObject.GetData Methode

Quelle:

DataObject.cs

Quelle:

DataObject.cs

Quelle:

DataObject.cs

Quelle:

DataObject.cs

Quelle:

DataObject.cs

public:
 virtual System::Object ^ GetData(System::String ^ format);

public virtual object GetData(string format);

[System.Obsolete("`DataObject.GetData` methods are obsolete. Use the corresponding `DataObject.TryGetData<T>` instead.", false, DiagnosticId="WFDEV005", UrlFormat="https://aka.ms/winforms-warnings/{0}")]
public virtual object? GetData(string format);

public virtual object? GetData(string format);

abstract member GetData : string -> obj
override this.GetData : string -> obj

[<System.Obsolete("`DataObject.GetData` methods are obsolete. Use the corresponding `DataObject.TryGetData<T>` instead.", false, DiagnosticId="WFDEV005", UrlFormat="https://aka.ms/winforms-warnings/{0}")>]
abstract member GetData : string -> obj
override this.GetData : string -> obj

Public Overridable Function GetData (format As String) As Object

Parameter

Gibt zurück

Die mit dem angegebenen Format verknüpften Daten oder null.

Implementiert

Attribute

ObsoleteAttribute

Beispiele

Im folgenden Codebeispiel werden die in einer DataObjectDatei gespeicherten Daten abgerufen. Zunächst wird ein neues DataObject mit Textdaten erstellt. Anschließend werden die Daten abgerufen, das Format als Zeichenfolge angegeben und in einem Textfeld angezeigt.

Dieser Code erfordert, dass textBox1 er erstellt wurde.

private:
   void AddMyData3()
   {
      // Creates a component to store in the data object.
      Component^ myComponent = gcnew Component;
      
      // Creates a new data object.
      DataObject^ myDataObject = gcnew DataObject;
      
      // Adds the component to the DataObject.
      myDataObject->SetData( myComponent );
      
      // Prints whether data of the specified type is in the DataObject.
      Type^ myType = myComponent->GetType();
      if ( myDataObject->GetDataPresent( myType ) )
      {
         textBox1->Text = String::Concat( "Data of type ", myType,
            " is present in the DataObject" );
      }
      else
      {
         textBox1->Text = String::Concat( "Data of type ", myType,
            " is not present in the DataObject" );
      }
   }

private void AddMyData3() {
    // Creates a component to store in the data object.
    Component myComponent = new Component();
 
    // Creates a new data object.
    DataObject myDataObject = new DataObject();
 
    // Adds the component to the DataObject.
    myDataObject.SetData(myComponent);
 
    // Prints whether data of the specified type is in the DataObject.
    Type myType = myComponent.GetType();
    if(myDataObject.GetDataPresent(myType))
       textBox1.Text = "Data of type " + myType.ToString() + 
       " is present in the DataObject";
    else
       textBox1.Text = "Data of type " + myType.ToString() +
       " is not present in the DataObject";
 }

Private Sub AddMyData3()
    ' Creates a component to store in the data object.
    Dim myComponent As New Component()
    
    ' Creates a new data object.
    Dim myDataObject As New DataObject()
    
    ' Adds the component to the DataObject.
    myDataObject.SetData(myComponent)
    
    ' Prints whether data of the specified type is in the DataObject.
    Dim myType As Type = myComponent.GetType()
    If myDataObject.GetDataPresent(myType) Then
        textBox1.Text = "Data of type " & myType.ToString() & _
            " is present in the DataObject"
    Else
        textBox1.Text = "Data of type " & myType.ToString() & _
            " is not present in the DataObject"
    End If
End Sub

Hinweise

Wenn diese Methode keine Daten im angegebenen Format finden kann, versucht sie, die Daten in das Format zu konvertieren. Wenn die Daten nicht in das angegebene Format konvertiert werden können oder wenn die Daten mit automatischer Konvertierung falsegespeichert wurden, wird diese Methode zurückgegeben null.

Um zu ermitteln, ob Daten mit einem Format, einem Aufruf vor dem Aufrufen GetDataPresentGetDataverknüpft oder konvertiert werden können. Rufen Sie GetFormats eine Liste gültiger Formate für die in dieser DataObjectDatei gespeicherten Daten auf.

Weitere Informationen

• SetData(String, Boolean, Object)
• GetDataPresent(Type)
• DataFormats
• GetFormats(Boolean)

Quelle:

DataObject.cs

Quelle:

DataObject.cs

Quelle:

DataObject.cs

Quelle:

DataObject.cs

Quelle:

DataObject.cs

public:
 virtual System::Object ^ GetData(Type ^ format);

public virtual object GetData(Type format);

[System.Obsolete("`DataObject.GetData` methods are obsolete. Use the corresponding `DataObject.TryGetData<T>` instead.", false, DiagnosticId="WFDEV005", UrlFormat="https://aka.ms/winforms-warnings/{0}")]
public virtual object? GetData(Type format);

public virtual object? GetData(Type format);

abstract member GetData : Type -> obj
override this.GetData : Type -> obj

[<System.Obsolete("`DataObject.GetData` methods are obsolete. Use the corresponding `DataObject.TryGetData<T>` instead.", false, DiagnosticId="WFDEV005", UrlFormat="https://aka.ms/winforms-warnings/{0}")>]
abstract member GetData : Type -> obj
override this.GetData : Type -> obj

Public Overridable Function GetData (format As Type) As Object

Parameter

Gibt zurück

Die mit dem angegebenen Format verknüpften Daten oder null.

Implementiert

Attribute

ObsoleteAttribute

Beispiele

Im folgenden Codebeispiel werden die in einer DataObjectDatei gespeicherten Daten abgerufen. Zunächst wird mit einer Komponente ein neues DataObject erstellt. Anschließend werden die Daten abgerufen und geben den Typ an. Der Typ der abgerufenen Daten wird in einem Textfeld angezeigt.

Dieser Code erfordert, dass textBox1 er erstellt wurde.

private:
   void GetMyData()
   {
      // 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();
      
      // Retrieves the data using myType to represent its type.
      Object^ myObject = myDataObject->GetData( myType );
      if ( myObject != nullptr )
      {
         textBox1->Text = String::Format( "The data type stored in the DataObject is: {0}",
            myObject->GetType()->Name );
      }
      else
      {
         textBox1->Text = "Data of the specified type was not stored in the DataObject.";
      }
   }

private void GetMyData() {
    // 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();
 
    // Retrieves the data using myType to represent its type.
    Object myObject = myDataObject.GetData(myType);
    if(myObject != null)
       textBox1.Text = "The data type stored in the DataObject is: " +
       myObject.GetType().Name;
    else
       textBox1.Text = "Data of the specified type was not stored " +
       "in the DataObject.";
 }

Private Sub GetMyData()
    ' 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()
    
    ' Retrieves the data using myType to represent its type.
    Dim myObject As Object = myDataObject.GetData(myType)
    If (myObject IsNot Nothing) Then
        textBox1.Text = "The data type stored in the DataObject is: " & myObject.GetType().Name
    Else
        textBox1.Text = "Data of the specified type was not stored " & "in the DataObject."
    End If
End Sub

Hinweise

Wenn diese Methode keine Daten im angegebenen Format finden kann, versucht sie, die Daten in das Format zu konvertieren. Wenn die Daten nicht in das angegebene Format konvertiert werden können oder wenn die Daten mit automatischer Konvertierung falsegespeichert wurden, wird diese Methode zurückgegeben null.

Um zu ermitteln, ob Daten mit einem Format, einem Aufruf vor dem Aufrufen GetDataPresentGetDataverknüpft oder konvertiert werden können. Rufen Sie GetFormats eine Liste gültiger Formate für die in dieser DataObjectDatei gespeicherten Daten auf.

Weitere Informationen

• SetData(String, Boolean, Object)
• Type
• GetDataPresent(Type)
• DataFormats
• GetFormats(Boolean)

Quelle:

DataObject.cs

Quelle:

DataObject.cs

Quelle:

DataObject.cs

Quelle:

DataObject.cs

Quelle:

DataObject.cs

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

public virtual object GetData(string format, bool autoConvert);

[System.Obsolete("`DataObject.GetData` methods are obsolete. Use the corresponding `DataObject.TryGetData<T>` instead.", false, DiagnosticId="WFDEV005", UrlFormat="https://aka.ms/winforms-warnings/{0}")]
public virtual object? GetData(string format, bool autoConvert);

public virtual object? GetData(string format, bool autoConvert);

abstract member GetData : string * bool -> obj
override this.GetData : string * bool -> obj

[<System.Obsolete("`DataObject.GetData` methods are obsolete. Use the corresponding `DataObject.TryGetData<T>` instead.", false, DiagnosticId="WFDEV005", UrlFormat="https://aka.ms/winforms-warnings/{0}")>]
abstract member GetData : string * bool -> obj
override this.GetData : string * bool -> obj

Public Overridable Function GetData (format As String, autoConvert As Boolean) As Object

Parameter

Gibt zurück

Die mit dem angegebenen Format verknüpften Daten oder null.

Implementiert

Attribute

ObsoleteAttribute

Beispiele

Im folgenden Codebeispiel werden die in einer DataObjectDatei gespeicherten Daten mithilfe des autoConvert Parameters abgerufen, um anzugeben, ob das Datenformat konvertiert werden soll.

Zunächst wird ein neues DataObject mit Textdaten erstellt. Anschließend versucht das Beispiel, die Daten abzurufen, das Format als Zeichenfolge und keine Formatkonvertierung anzugeben, d. h. der autoConvert Parameter ist false. Dieser Vorgang schlägt fehl, da keine Zeichenfolgendaten in der DataObject.

Als Nächstes versucht das Beispiel, die Daten erneut abzurufen, wobei der autoConvert Parameter auf . true festgelegt ist. Dieser Vorgang ist erfolgreich, und die Ergebnisse werden in einer MessageBox.

Dieser Code erfordert, dass textBox1 er erstellt wurde.

private:
   void GetMyData3()
   {
      // Creates a new data object using a string and the text format.
      String^ myString = "My new text string";
      DataObject^ myDataObject = gcnew DataObject( DataFormats::Text,myString );
      
      // Prints the string in a text box with autoconvert = false.
      if ( myDataObject->GetData( "System.String", false ) != 0 )
      {
         // Prints the string in a text box.
         textBox1->Text = String::Concat(
            myDataObject->GetData( "System.String", false )->ToString(), "\n" );
      }
      else
      {
         textBox1->Text = "Could not find data of the specified format\n";
      }
      
      // Prints the string in a text box with autoconvert = true.
      textBox1->Text = String::Concat(
            textBox1->Text, myDataObject->GetData( "System.String", true )->ToString() );
   }

private void GetMyData3() {
    // Creates a new data object using a string and the text format.
    string myString = "My new text string";
    DataObject myDataObject = new DataObject(DataFormats.Text, myString);
 
    // Prints the string in a text box with autoconvert = false.
    if(myDataObject.GetData("System.String", false) != null) {
       // Prints the string in a text box.
       textBox1.Text = myDataObject.GetData("System.String", false).ToString() + '\n';
    } else
        {
            textBox1.Text = "Could not find data of the specified format" + '\n';
        }

        // Prints the string in a text box with autoconvert = true.
        textBox1.Text += myDataObject.GetData("System.String", true).ToString();
 }

Private Sub GetMyData3()
    ' Creates a new data object using a string and the text format.
    Dim myString As String = "My new text string"
    Dim myDataObject As New DataObject(DataFormats.Text, myString)
    
    ' Prints the string in a text box with autoconvert = false.
    If (myDataObject.GetData("System.String", False) IsNot Nothing) Then
        ' Prints the string in a text box.
        textBox1.Text = myDataObject.GetData("System.String", False).ToString() & ControlChars.Cr
    Else
        textBox1.Text = "Could not find data of the specified format" & ControlChars.Cr
    End If 
    ' Prints the string in a text box with autoconvert = true.
    textBox1.Text += myDataObject.GetData("System.String", True).ToString()
End Sub

Hinweise

Wenn der autoConvert Parameter und true diese Methode keine Daten im angegebenen Format finden kann, versucht sie, die Daten in das Format zu konvertieren. Wenn die Daten nicht in das angegebene Format konvertiert werden können oder wenn die Daten mit dem automatischen Konvertierungssatz falsegespeichert wurden, gibt diese Methode zurück null.

Wenn der autoConvert Parameter lautet false, gibt diese Methode Daten im angegebenen Format zurück oder null wenn keine Daten in diesem Format gefunden werden.

Um zu ermitteln, ob Daten mit einem Format, einem Aufruf vor dem Aufrufen GetDataPresentGetDataverknüpft oder konvertiert werden können. Rufen Sie GetFormats eine Liste gültiger Formate für die in dieser DataObjectDatei gespeicherten Daten auf.

Weitere Informationen

• SetData(String, Boolean, Object)
• GetDataPresent(Type)
• DataFormats
• GetFormats(Boolean)