DataObject.GetData Metod

Definition

Returnerar de data som är associerade med det angivna dataformatet.

Överlagringar

Name Description
GetData(String)
Föråldrad.

Returnerar de data som är associerade med det angivna dataformatet.

GetData(Type)
Föråldrad.

Returnerar de data som är associerade med det angivna klasstypsformatet.

GetData(String, Boolean)
Föråldrad.

Returnerar data som är associerade med det angivna dataformatet med hjälp av en automatiserad konverteringsparameter för att avgöra om data ska konverteras till formatet.

GetData(String)

Källa:
DataObject.cs
Källa:
DataObject.cs
Källa:
DataObject.cs
Källa:
DataObject.cs
Källa:
DataObject.cs

Varning

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

Returnerar de data som är associerade med det angivna dataformatet.

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

Parametrar

format
String

Formatet för de data som ska hämtas. Se DataFormats fördefinierade format.

Returer

De data som är associerade med det angivna formatet, eller null.

Implementeringar

Attribut

Exempel

I följande kodexempel hämtas data som lagras i en DataObject. Först skapas en ny DataObject med textdata. Sedan hämtas data, anger dess format som en sträng och visas i en textruta.

Den här koden kräver att den textBox1 har skapats.

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

Kommentarer

Om den här metoden inte kan hitta data i det angivna formatet försöker den konvertera data till formatet. Om data inte kan konverteras till det angivna formatet, eller om data har lagrats med automatisk konvertering inställd på false, returnerar nullden här metoden .

För att avgöra om data är associerade med eller kan konverteras till ett format anropar GetDataPresent du innan du anropar GetData. Anropa GetFormats en lista över giltiga format för data som lagras i den här DataObject.

Note

Data kan konverteras till ett annat format om de har lagrats och anger att konvertering tillåts och om det begärda formatet är kompatibelt med det lagrade formatet. Data som lagras som Unicode kan till exempel konverteras till text.

När format är Html returnerar den här metoden en UTF-8-kodad sträng i program som är inriktade på .NET 4,5 eller senare och en ANSI-kodad sträng i program som riktar sig mot .NET 4,0 eller lägre.

Se även

Gäller för

GetData(Type)

Källa:
DataObject.cs
Källa:
DataObject.cs
Källa:
DataObject.cs
Källa:
DataObject.cs
Källa:
DataObject.cs

Varning

DataObject.GetData methods are obsolete. Use the corresponding DataObject.TryGetData&lt;T&gt; instead.

Returnerar de data som är associerade med det angivna klasstypsformatet.

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

Parametrar

format
Type

En Type som representerar formatet på de data som ska hämtas.

Returer

De data som är associerade med det angivna formatet, eller null.

Implementeringar

Attribut

Exempel

I följande kodexempel hämtas data som lagras i en DataObject. Först skapas en ny DataObject med en komponent. Sedan hämtas data och anger dess typ. Typen av hämtade data visas i en textruta.

Den här koden kräver att den textBox1 har skapats.

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

Kommentarer

Om den här metoden inte kan hitta data i det angivna formatet försöker den konvertera data till formatet. Om data inte kan konverteras till det angivna formatet, eller om data har lagrats med automatisk konvertering inställd på false, returnerar nullden här metoden .

För att avgöra om data är associerade med eller kan konverteras till ett format anropar GetDataPresent du innan du anropar GetData. Anropa GetFormats en lista över giltiga format för data som lagras i den här DataObject.

Note

Data kan konverteras till ett annat format om de har lagrats och anger att konvertering tillåts och om det begärda formatet är kompatibelt med det lagrade formatet. Data som lagras som Unicode kan till exempel konverteras till text.

Se även

Gäller för

GetData(String, Boolean)

Källa:
DataObject.cs
Källa:
DataObject.cs
Källa:
DataObject.cs
Källa:
DataObject.cs
Källa:
DataObject.cs

Varning

DataObject.GetData methods are obsolete. Use the corresponding DataObject.TryGetData&lt;T&gt; instead.

Returnerar data som är associerade med det angivna dataformatet med hjälp av en automatiserad konverteringsparameter för att avgöra om data ska konverteras till formatet.

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

Parametrar

format
String

Formatet för de data som ska hämtas. Se DataFormats fördefinierade format.

autoConvert
Boolean

truetill konvertera data till det angivna formatet. annars . false

Returer

De data som är associerade med det angivna formatet, eller null.

Implementeringar

Attribut

Exempel

I följande kodexempel hämtas data som lagras i en DataObject, med hjälp av parametern autoConvert för att ange om dataformatet ska konverteras.

Först skapas en ny DataObject med textdata. Sedan försöker exemplet hämta data, ange dess format som en sträng och ingen formatkonvertering, det vill säga parametern autoConvert är false. Den här åtgärden misslyckas eftersom det inte finns några strängdata i DataObject.

Sedan försöker exemplet hämta data igen, med parametern autoConvert inställd på true. Den här åtgärden lyckas och resultatet visas i en MessageBox.

Den här koden kräver att den textBox1 har skapats.

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

Kommentarer

Om parametern autoConvert är true och den här metoden inte kan hitta data i det angivna formatet försöker den konvertera data till formatet. Om data inte kan konverteras till det angivna formatet, eller om data har lagrats med den automatiska konverteringen inställd på false, returnerar nullden här metoden .

Om parametern autoConvert är falsereturnerar den här metoden data i det angivna formatet eller null om inga data i det här formatet kan hittas.

För att avgöra om data är associerade med eller kan konverteras till ett format anropar GetDataPresent du innan du anropar GetData. Anropa GetFormats en lista över giltiga format för data som lagras i den här DataObject.

Note

Data kan konverteras till ett annat format om de har lagrats och anger att konvertering tillåts och om det begärda formatet är kompatibelt med det lagrade formatet. Data som lagras som Unicode kan till exempel konverteras till text.

När format är Html returnerar den här metoden en UTF-8-kodad sträng i program som är inriktade på .NET 4,5 eller senare och en ANSI-kodad sträng i program som riktar sig mot .NET 4,0 eller lägre.

Se även

Gäller för