IDataObject.GetData Metod

Definition

Namnområde:
System.Windows.Forms
Sammansättning:
System.Windows.Forms.dll

Hämtar data som är associerade med det angivna dataformatet.

Överlagringar

Name Description
GetData(String)

Hämtar data som är associerade med det angivna dataformatet.
GetData(Type)

Hämtar data som är associerade med det angivna klasstypsformatet.
GetData(String, Boolean)

Hämtar data som är associerade med det angivna dataformatet med hjälp av ett booleskt värde för att avgöra om data ska konverteras till formatet.

GetData(String)

Källa:
IDataObject.cs
Källa:
IDataObject.cs
Källa:
IDataObject.cs
Källa:
IDataObject.cs
Källa:
IDataObject.cs

Hämtar data som är associerade med det angivna dataformatet.

public:
 System::Object ^ GetData(System::String ^ format);
public object GetData(string format);
public object? GetData(string format);
abstract member GetData : string -> obj
Public 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

Object

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

Exempel

I det DataObject här exemplet används klassen som implementeras IDataObject, för att demonstrera användningen av GetData metoden. Metoden används för att hämta data som lagras i myDataObject, som är associerad med Text formatet. Exemplet förutsätter att du redan har skapat ett Form namn och ett Form1 med namnet TextBoxtextBox1 .

private:
   void GetData1()
   {
      // Creates a new data object using a string and the text format.
      String^ myString = "My text string";
      DataObject^ myDataObject = gcnew DataObject( DataFormats::Text,myString );

      // Displays the string in a text box.
      textBox1->Text = myDataObject->GetData( DataFormats::Text )->ToString();
   }

private void GetData1() 
{
    // Creates a new data object using a string and the text format.
    string myString = "My text string";
    DataObject myDataObject = new DataObject(DataFormats.Text, myString);

    // Displays the string in a text box.
    textBox1.Text = myDataObject.GetData(DataFormats.Text).ToString();
}

Private Sub GetData1()
    ' Creates a new data object using a string and the text format.
    Dim myString As String = "My text string"
    Dim myDataObject As New DataObject(DataFormats.Text, myString)

    ' Displays the string in a text box.
    textBox1.Text = myDataObject.GetData(DataFormats.Text).ToString()
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 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 de data som lagras i den här instansen.

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.

En implementering av den här metoden finns i DataObject.GetData.

Se även

Gäller för

GetData(Type)

Källa:
IDataObject.cs
Källa:
IDataObject.cs
Källa:
IDataObject.cs
Källa:
IDataObject.cs
Källa:
IDataObject.cs

Hämtar data som är associerade med det angivna klasstypsformatet.

public:
 System::Object ^ GetData(Type ^ format);
public object GetData(Type format);
public object? GetData(Type format);
abstract member GetData : Type -> obj
Public Function GetData (format As Type) As Object

Parametrar

format
Type

En Type som representerar formatet på de data som ska hämtas. Se DataFormats fördefinierade format.

Returer

Object

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

Exempel

I det DataObject här exemplet används klassen, som implementerar IDataObject, för att demonstrera användningen av GetData metoden. Metoden används för att hämta data som lagras i myObject, som är associerad med en viss typ, myType. Typen av hämtade data visas i en meddelanderuta. Exemplet förutsätter att du redan har skapat en Form med namnet Form1.

private:
   void GetData2()
   {
      // Creates a component.
      Component^ myComponent = gcnew Component;

      // Creates a data object, and assigns it the component.
      DataObject^ myDataObject = gcnew DataObject( myComponent );

      // Creates a type, myType, 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 )
            MessageBox::Show( "The data type stored in the data object is " +
                  myObject->GetType()->Name + "." );
      else
            MessageBox::Show( "Data of the specified type was not stored in the data object." );
   }

       private void GetData2() 
       {
           // Creates a component.
           Component myComponent = new Component();

           // Creates a data object, and assigns it the component.
           DataObject myDataObject = new DataObject(myComponent);

           // Creates a type, myType, 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)
               MessageBox.Show("The data type stored in the data object is " +
                   myObject.GetType().Name + ".");
           else
               MessageBox.Show("Data of the specified type was not stored " +
                   "in the data object.");
       }

Private Sub GetData2()
    ' Creates a component.
    Dim myComponent As New System.ComponentModel.Component()

    ' Creates a data object, and assigns it the component.
    Dim myDataObject As New DataObject(myComponent)

    ' Creates a type, myType, 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
        MessageBox.Show("The data type stored in the data object is " + myObject.GetType().Name + ".")
    Else
        MessageBox.Show("Data of the specified type was not stored " + "in the data object.")
    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 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 de data som lagras i den här instansen.

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.

En implementering av den här metoden finns i DataObject.GetData.

Se även

Gäller för

GetData(String, Boolean)

Källa:
IDataObject.cs
Källa:
IDataObject.cs
Källa:
IDataObject.cs
Källa:
IDataObject.cs
Källa:
IDataObject.cs

Hämtar data som är associerade med det angivna dataformatet med hjälp av ett booleskt värde för att avgöra om data ska konverteras till formatet.

public:
 System::Object ^ GetData(System::String ^ format, bool autoConvert);
public object GetData(string format, bool autoConvert);
public object? GetData(string format, bool autoConvert);
abstract member GetData : string * bool -> obj
Public 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

trueför att konvertera data till det angivna formatet. annars . false

Returer

Object

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

Exempel

I det DataObject här exemplet används klassen, som implementerar IDataObject, för att demonstrera användningen av GetData metoden. Exemplet hämtar data som lagras i en DataObject, med hjälp av parametern autoConvert för att ange om dataformatet ska konverteras eller inte. myDataObject Först skapas med textdata. Sedan försöker exemplet två gånger att hämta data. I den första utvärderingsversionen anger den formatet som en sträng och anger parametern autoConvert till false. Den här utvärderingsversionen misslyckas och resultatet visas i en meddelanderuta med etiketten "Meddelande nr 1". I den andra utvärderingsversionen hämtar exemplet samma data med parametern inställd på autoConverttrue. Den här utvärderingsversionen lyckas och resultatet visas i en meddelanderuta med etiketten "Meddelande nr 2". Exemplet förutsätter att du har skapat en Form med namnet Form1.

private:
   void GetData3()
   {
      // Creates a new data object using a text string.
      String^ myString = "Hello World!";
      DataObject^ myDataObject = gcnew DataObject( DataFormats::Text,myString );

      // Displays the string with autoConvert equal to false.
      if ( myDataObject->GetData( "System::String", false ) != nullptr )
      {
         // Displays the string in a message box.
         MessageBox::Show( myDataObject->GetData( "System::String", false ) + ".", "Message #1" );
      }
      else
            MessageBox::Show( "Could not find data of the specified format.", "Message #1" );

      // Displays a not found message in a message box.
      // Displays the string in a text box with autoConvert equal to true.
      String^ myData = "The data is " + myDataObject->GetData( "System::String", true ) + ".";
      MessageBox::Show( myData, "Message #2" );
   }

       private void GetData3() 
       {
           // Creates a new data object using a text string.
           string myString = "Hello World!";
           DataObject myDataObject = new DataObject(DataFormats.Text, myString);

           // Displays the string with autoConvert equal to false.
           if (myDataObject.GetData("System.String", false) != null) 
           {
               // Displays the string in a message box.
               MessageBox.Show(myDataObject.GetData("System.String", false).ToString() + ".", "Message #1");
           } 
           else
           {
               // Displays a not found message in a message box.
               MessageBox.Show("Could not find data of the specified format.", "Message #1");
           }

           // Displays the string in a text box with autoConvert equal to true.
           string myData = "The data is " + myDataObject.GetData("System.String", true).ToString() +".";
           MessageBox.Show(myData,"Message #2");
       }

Private Sub GetData3()
    ' Creates a new data object using a text string.
    Dim myString As String = "Hello World!"
    Dim myDataObject As New DataObject(DataFormats.Text, myString)

    ' Displays the string with autoConvert equal to false.
    If (myDataObject.GetData("System.String", False) IsNot Nothing) Then
        ' Displays the string in a message box.
        MessageBox.Show(myDataObject.GetData("System.String", False).ToString() + ".", "Message #1")
        ' Displays a not found message in a message box.
    Else
        MessageBox.Show("Could not find data of the specified format.", "Message #1")
    End If

    ' Displays the string in a text box with autoConvert equal to true.
    Dim myData As String = "The data is " + myDataObject.GetData("System.String", True).ToString()
    MessageBox.Show(myData, "Message #2")
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 lagrades med parametern autoConvert 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 de data som lagras i den här instansen.

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.

En implementering av den här metoden finns i DataObject.GetData.

Se även

Gäller för