DataObject.GetData Metódus

Definíció

Névtér:

System.Windows.Forms

Szerelvény:

System.Windows.Forms.dll

A megadott adatformátumhoz társított adatokat adja vissza.

Túlterhelések

Name	Description
GetData(String)	Elavult. A megadott adatformátumhoz társított adatokat adja vissza.
GetData(Type)	Elavult. A megadott osztálytípus-formátumhoz társított adatokat adja vissza.
GetData(String, Boolean)	Elavult. A megadott adatformátumhoz társított adatokat adja vissza egy automatizált konverziós paraméter használatával annak meghatározásához, hogy az adatokat formátummá konvertálja-e.

GetData(String)

Forrás:

DataObject.cs

Figyelemfelhívás

DataObject.GetData methods are obsolete. Use the corresponding DataObject.TryGetData<T> instead.

A megadott adatformátumhoz társított adatokat adja vissza.

public:
 virtual System::Object ^ GetData(System::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);

[<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

Paraméterek

format

String

A lekérendő adatok formátuma. Előre DataFormats definiált formátumok megtekintése.

Válaszok

Object

A megadott formátumhoz nullvagy .

Megvalósítás

GetData(String)

Attribútumok

ObsoleteAttribute

Példák

Az alábbi példakód beolvassa a fájlban DataObjecttárolt adatokat. Először egy új DataObject jön létre szöveges adatokkal. Ezután lekéri az adatokat, megadva annak formátumát sztringként, és megjelenik egy szövegdobozban.

Ehhez a kódhoz létre kell textBox1 hozni.

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

Megjegyzések

Ha ez a metódus nem találja a megadott formátumban lévő adatokat, megkísérli átalakítani az adatokat a formátumba. Ha az adatok nem konvertálhatók a megadott formátumra, vagy ha az adatokat automatikus átalakítással falsetárolták, ez a metódus ad vissza null.

Annak megállapításához, hogy az adatok társítva vagy átalakíthatók-e formátumhoz, hívás GetDataPresentelőtt hívjanakGetData. Hívja meg GetFormats az ebben DataObjecta szakaszban tárolt adatok érvényes formátumainak listáját.

Note

Az adatok egy másik formátumba konvertálhatók, ha a tárolásuk azt határozza meg, hogy engedélyezett-e az átalakítás, és ha a kért formátum kompatibilis a tárolt formátummal. A Unicode-ként tárolt adatok például szöveggé alakíthatók.

Ha formatHtml, ez a metódus egy UTF-8 kódolású sztringet ad vissza a 4.5-ös vagy újabb .NET megcélzott alkalmazásokban, valamint egy ANSI-kódolású sztringet azokban az alkalmazásokban, amelyek 4.0-s vagy annál alacsonyabb .NET célként.

Lásd még

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

GetData(Type)

Forrás:

DataObject.cs

Figyelemfelhívás

DataObject.GetData methods are obsolete. Use the corresponding DataObject.TryGetData<T> instead.

A megadott osztálytípus-formátumhoz társított adatokat adja vissza.

public:
 virtual System::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);

[<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

Paraméterek

format

Type

A Type lekérni kívánt adatok formátumát jelöli.

Válaszok

Object

A megadott formátumhoz nullvagy .

Megvalósítás

GetData(Type)

Attribútumok

ObsoleteAttribute

Példák

Az alábbi példakód beolvassa a fájlban DataObjecttárolt adatokat. Először egy új DataObject jön létre egy összetevővel. Ezután a rendszer lekéri az adatokat, megadva annak típusát. A beolvasott adatok típusa megjelenik egy szövegdobozban.

Ehhez a kódhoz létre kell textBox1 hozni.

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

Megjegyzések

Ha ez a metódus nem találja a megadott formátumban lévő adatokat, megkísérli átalakítani az adatokat a formátumba. Ha az adatok nem konvertálhatók a megadott formátumra, vagy ha az adatokat automatikus átalakítással falsetárolták, ez a metódus ad vissza null.

Annak megállapításához, hogy az adatok társítva vagy átalakíthatók-e formátumhoz, hívás GetDataPresentelőtt hívjanakGetData. Hívja meg GetFormats az ebben DataObjecta szakaszban tárolt adatok érvényes formátumainak listáját.

Note

Az adatok egy másik formátumba konvertálhatók, ha a tárolásuk azt határozza meg, hogy engedélyezett-e az átalakítás, és ha a kért formátum kompatibilis a tárolt formátummal. A Unicode-ként tárolt adatok például szöveggé alakíthatók.

Lásd még

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

GetData(String, Boolean)

Forrás:

DataObject.cs

Figyelemfelhívás

DataObject.GetData methods are obsolete. Use the corresponding DataObject.TryGetData<T> instead.

A megadott adatformátumhoz társított adatokat adja vissza egy automatizált konverziós paraméter használatával annak meghatározásához, hogy az adatokat formátummá konvertálja-e.

public:
 virtual System::Object ^ GetData(System::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);

[<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

Paraméterek

format

String

A lekérendő adatok formátuma. Előre DataFormats definiált formátumok megtekintése.

autoConvert

Boolean

trueaz adatok konvertálása a megadott formátumra; egyéb esetben. false

Válaszok

Object

A megadott formátumhoz nullvagy .

Megvalósítás

GetData(String, Boolean)

Attribútumok

ObsoleteAttribute

Példák

Az alábbi példakód lekéri a paraméterrel DataObject egy adott helyen autoConverttárolt adatokat, és megadja, hogy konvertálja-e az adatformátumot.

Először egy új DataObject jön létre szöveges adatokkal. Ezután a példa megpróbálja lekérni az adatokat, és sztringként adja meg a formátumát, és nincs formátumkonvertálás, azaz a paraméter.autoConvertfalse Ez a művelet meghiúsul, mert nincs sztringadat a DataObject.

Ezután a példa újra megpróbálja lekérni az adatokat, és a paraméter értéke a autoConvert következő true. Ez a művelet sikeres, és az eredmények megjelennek egy MessageBox.

Ehhez a kódhoz létre kell textBox1 hozni.

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

Megjegyzések

Ha a autoConvert paraméter az, true és ez a metódus nem találja a megadott formátumban lévő adatokat, megkísérli konvertálni az adatokat a formátumba. Ha az adatok nem konvertálhatók a megadott formátumra, vagy ha az adatokat az automatikus konvertálási beállítással falsetárolták, ez a metódus ad vissza null.

Ha a autoConvert paraméter az false, akkor ez a metódus a megadott formátumban adja vissza az adatokat, vagy null ha ebben a formátumban nem található adat.

Annak megállapításához, hogy az adatok társítva vagy átalakíthatók-e formátumhoz, hívás GetDataPresentelőtt hívjanakGetData. Hívja meg GetFormats az ebben DataObjecta szakaszban tárolt adatok érvényes formátumainak listáját.

Note

Az adatok egy másik formátumba konvertálhatók, ha a tárolásuk azt határozza meg, hogy engedélyezett-e az átalakítás, és ha a kért formátum kompatibilis a tárolt formátummal. A Unicode-ként tárolt adatok például szöveggé alakíthatók.

Ha formatHtml, ez a metódus egy UTF-8 kódolású sztringet ad vissza a 4.5-ös vagy újabb .NET megcélzott alkalmazásokban, valamint egy ANSI-kódolású sztringet azokban az alkalmazásokban, amelyek 4.0-s vagy annál alacsonyabb .NET célként.

Lásd még

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