Bagikan melalui

DataObject.GetData Metode

  • Referensi

Definisi

Ruang nama:
System.Windows.Forms
Rakitan:
System.Windows.Forms.dll

Mengembalikan data yang terkait dengan format data yang ditentukan.

Overload

GetData(String, Boolean)

Mengembalikan data yang terkait dengan format data yang ditentukan, menggunakan parameter konversi otomatis untuk menentukan apakah akan mengonversi data ke format.
GetData(String)

Mengembalikan data yang terkait dengan format data yang ditentukan.
GetData(Type)

Mengembalikan data yang terkait dengan format jenis kelas yang ditentukan.

GetData(String, Boolean)

Mengembalikan data yang terkait dengan format data yang ditentukan, menggunakan parameter konversi otomatis untuk menentukan apakah akan mengonversi data ke format.

public:
 virtual System::Object ^ GetData(System::String ^ format, bool autoConvert);
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
Public Overridable Function GetData (format As String, autoConvert As Boolean) As Object

Parameter

format
String

Format data yang akan diambil. Lihat DataFormats untuk format yang telah ditentukan sebelumnya.

autoConvert
Boolean

true ke mengonversi data ke format yang ditentukan; jika tidak, false.

Mengembalikan

Object

Data yang terkait dengan format yang ditentukan, atau null.

Penerapan

GetData(String, Boolean)

Contoh

Contoh kode berikut mengambil data yang disimpan dalam DataObject, menggunakan autoConvert parameter untuk menentukan apakah akan mengonversi format data.

Pertama, baru DataObject dibuat dengan data teks. Kemudian contoh mencoba mengambil data, menentukan formatnya sebagai string dan tidak ada konversi format, yaitu, autoConvert parameternya adalah false. Operasi ini gagal karena tidak ada data string di DataObject.

Selanjutnya, contoh mencoba mengambil data lagi, dengan parameter diatur autoConvert ke true. Operasi ini berhasil dan hasilnya ditampilkan dalam MessageBox.

Kode ini mengharuskan yang textBox1 telah dibuat.

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

Keterangan

autoConvert Jika parameter adalah true dan metode ini tidak dapat menemukan data dalam format yang ditentukan, parameter mencoba mengonversi data ke format . Jika data tidak dapat dikonversi ke format yang ditentukan, atau jika data disimpan dengan konversi otomatis diatur ke false, metode ini mengembalikan null.

autoConvert Jika parameter adalah false, metode ini mengembalikan data dalam format yang ditentukan, atau null jika tidak ada data dalam format ini yang dapat ditemukan.

Untuk menentukan apakah data dikaitkan dengan, atau dapat dikonversi ke, format, panggil GetDataPresent sebelum memanggil GetData. Panggil GetFormats daftar format yang valid untuk data yang disimpan dalam ini DataObject.

Catatan

Data dapat dikonversi ke format lain jika disimpan yang menentukan bahwa konversi diizinkan, dan jika format yang diminta kompatibel dengan format tersimpan. Misalnya, data yang disimpan sebagai Unicode dapat dikonversi ke teks.

Ketika format adalah Html, metode ini mengembalikan string yang dikodekan UTF-8 dalam aplikasi yang menargetkan .NET 4.5 atau yang lebih tinggi, dan string yang dikodekan ANSI dalam aplikasi yang menargetkan .NET 4.0 atau lebih rendah.

Lihat juga

Berlaku untuk

GetData(String)

Mengembalikan data yang terkait dengan format data yang ditentukan.

public:
 virtual System::Object ^ GetData(System::String ^ format);
public virtual object GetData (string format);
public virtual object? GetData (string format);
abstract member GetData : string -> obj
override this.GetData : string -> obj
Public Overridable Function GetData (format As String) As Object

Parameter

format
String

Format data yang akan diambil. Lihat DataFormats untuk format yang telah ditentukan sebelumnya.

Mengembalikan

Object

Data yang terkait dengan format yang ditentukan, atau null.

Penerapan

GetData(String)

Contoh

Contoh kode berikut mengambil data yang disimpan dalam DataObject. Pertama, baru DataObject dibuat dengan data teks. Kemudian, data diambil, menentukan formatnya sebagai string, dan ditampilkan dalam kotak teks.

Kode ini mengharuskan yang textBox1 telah dibuat.

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

Keterangan

Jika metode ini tidak dapat menemukan data dalam format yang ditentukan, metode ini mencoba mengonversi data ke format . Jika data tidak dapat dikonversi ke format yang ditentukan, atau jika data disimpan dengan konversi otomatis diatur ke false, metode ini mengembalikan null.

Untuk menentukan apakah data dikaitkan dengan, atau dapat dikonversi ke, format, panggil GetDataPresent sebelum memanggil GetData. Panggil GetFormats daftar format yang valid untuk data yang disimpan dalam ini DataObject.

Catatan

Data dapat dikonversi ke format lain jika disimpan yang menentukan bahwa konversi diizinkan, dan jika format yang diminta kompatibel dengan format tersimpan. Misalnya, data yang disimpan sebagai Unicode dapat dikonversi ke teks.

Ketika format adalah Html, metode ini mengembalikan string yang dikodekan UTF-8 dalam aplikasi yang menargetkan .NET 4.5 atau yang lebih tinggi, dan string yang dikodekan ANSI dalam aplikasi yang menargetkan .NET 4.0 atau lebih rendah.

Lihat juga

Berlaku untuk

GetData(Type)

Mengembalikan data yang terkait dengan format jenis kelas yang ditentukan.

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

Parameter

format
Type

mewakili Type format data yang akan diambil.

Mengembalikan

Object

Data yang terkait dengan format yang ditentukan, atau null.

Penerapan

GetData(Type)

Contoh

Contoh kode berikut mengambil data yang disimpan dalam DataObject. Pertama, baru DataObject dibuat dengan komponen. Kemudian, data diambil, menentukan jenisnya. Jenis data yang diambil ditampilkan dalam kotak teks.

Kode ini mengharuskan yang textBox1 telah dibuat.

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

Keterangan

Jika metode ini tidak dapat menemukan data dalam format yang ditentukan, metode ini mencoba mengonversi data ke format . Jika data tidak dapat dikonversi ke format yang ditentukan, atau jika data disimpan dengan konversi otomatis diatur ke false, metode ini mengembalikan null.

Untuk menentukan apakah data dikaitkan dengan, atau dapat dikonversi ke, format, panggil GetDataPresent sebelum memanggil GetData. Panggil GetFormats daftar format yang valid untuk data yang disimpan dalam ini DataObject.

Catatan

Data dapat dikonversi ke format lain jika disimpan yang menentukan bahwa konversi diizinkan, dan jika format yang diminta kompatibel dengan format tersimpan. Misalnya, data yang disimpan sebagai Unicode dapat dikonversi ke teks.

Lihat juga

Berlaku untuk