Partilhar via

DataObject.GetData Método

  • Referência

Definição

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Retorna os dados associados ao formato de dados especificado.

Sobrecargas

GetData(String, Boolean)

Retorna os dados associados com o formato de dados especificado, usando um parâmetro de conversão automatizado para determinar se os dados devem ou não ser convertidos para o formato.
GetData(String)

Retorna os dados associados ao formato de dados especificado.
GetData(Type)

Retorna os dados associados ao formato do tipo de classe especificado.

GetData(String, Boolean)

Retorna os dados associados com o formato de dados especificado, usando um parâmetro de conversão automatizado para determinar se os dados devem ou não ser convertidos para o formato.

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

Parâmetros

format
String

O formato dos dados a serem recuperados. Consulte DataFormats para obter os formatos predefinidos.

autoConvert
Boolean

true para converter os dados para o formato especificado; caso contrário, false.

Retornos

Object

Os dados associados ao formato especificado ou null.

Implementações

GetData(String, Boolean)

Exemplos

O exemplo de código a seguir recupera os dados armazenados em um DataObject, usando o autoConvert parâmetro para especificar se o formato de dados deve ser convertido.

Primeiro, um novo DataObject é criado com dados de texto. Em seguida, o exemplo tenta recuperar os dados, especificando seu formato como uma cadeia de caracteres e nenhuma conversão de formato, ou seja, o autoConvert parâmetro é false. Essa operação falha porque não há dados de cadeia de caracteres no DataObject.

Em seguida, o exemplo tenta recuperar os dados novamente, com o autoConvert parâmetro definido truecomo . Essa operação é bem-sucedida e os resultados são exibidos em um MessageBox.

Esse código requer que textBox1 tenha sido criado.

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

Comentários

Se o autoConvert parâmetro for true e esse método não puder encontrar dados no formato especificado, ele tentará converter os dados no formato. Se os dados não puderem ser convertidos no formato especificado ou se os dados tiverem sido armazenados com a conversão automática definida como false, esse método retornará null.

Se o autoConvert parâmetro for false, esse método retornará dados no formato especificado ou null se nenhum dado nesse formato puder ser encontrado.

Para determinar se os dados estão associados ou podem ser convertidos em um formato, chame GetDataPresent antes de chamar GetData. Chame GetFormats uma lista de formatos válidos para os dados armazenados neste DataObject.

Observação

Os dados poderão ser convertidos em outro formato se forem armazenados especificando se a conversão é permitida e se o formato solicitado for compatível com o formato armazenado. Por exemplo, os dados armazenados como Unicode podem ser convertidos em texto.

Quando format é Html, esse método retorna uma cadeia de caracteres codificada em UTF-8 em aplicativos direcionados ao .NET 4.5 ou superior e uma cadeia de caracteres codificada em ANSI em aplicativos direcionados ao .NET 4.0 ou inferior.

Confira também

Aplica-se a

GetData(String)

Retorna os dados associados ao formato de dados especificado.

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

Parâmetros

format
String

O formato dos dados a serem recuperados. Consulte DataFormats para obter os formatos predefinidos.

Retornos

Object

Os dados associados ao formato especificado ou null.

Implementações

GetData(String)

Exemplos

O exemplo de código a seguir recupera os dados armazenados em um DataObject. Primeiro, um novo DataObject é criado com dados de texto. Em seguida, os dados são recuperados, especificando seu formato como uma cadeia de caracteres e exibidos em uma caixa de texto.

Esse código requer que textBox1 tenha sido criado.

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

Comentários

Se esse método não puder encontrar dados no formato especificado, ele tentará converter os dados no formato. Se os dados não puderem ser convertidos no formato especificado ou se os dados tiverem sido armazenados com conversão automática definida como false, esse método retornará null.

Para determinar se os dados estão associados ou podem ser convertidos em um formato, chame GetDataPresent antes de chamar GetData. Chame GetFormats uma lista de formatos válidos para os dados armazenados neste DataObject.

Observação

Os dados poderão ser convertidos em outro formato se forem armazenados especificando se a conversão é permitida e se o formato solicitado for compatível com o formato armazenado. Por exemplo, os dados armazenados como Unicode podem ser convertidos em texto.

Quando format é Html, esse método retorna uma cadeia de caracteres codificada em UTF-8 em aplicativos direcionados ao .NET 4.5 ou superior e uma cadeia de caracteres codificada em ANSI em aplicativos direcionados ao .NET 4.0 ou inferior.

Confira também

Aplica-se a

GetData(Type)

Retorna os dados associados ao formato do tipo de classe especificado.

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

Parâmetros

format
Type

Um Type que representa o formato dos dados a serem recuperados.

Retornos

Object

Os dados associados ao formato especificado ou null.

Implementações

GetData(Type)

Exemplos

O exemplo de código a seguir recupera os dados armazenados em um DataObject. Primeiro, um novo DataObject é criado com um componente . Em seguida, os dados são recuperados, especificando seu tipo. O tipo dos dados recuperados é exibido em uma caixa de texto.

Esse código requer que textBox1 tenha sido criado.

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

Comentários

Se esse método não puder encontrar dados no formato especificado, ele tentará converter os dados no formato. Se os dados não puderem ser convertidos no formato especificado ou se os dados tiverem sido armazenados com conversão automática definida como false, esse método retornará null.

Para determinar se os dados estão associados ou podem ser convertidos em um formato, chame GetDataPresent antes de chamar GetData. Chame GetFormats uma lista de formatos válidos para os dados armazenados neste DataObject.

Observação

Os dados poderão ser convertidos em outro formato se forem armazenados especificando se a conversão é permitida e se o formato solicitado for compatível com o formato armazenado. Por exemplo, os dados armazenados como Unicode podem ser convertidos em texto.

Confira também

Aplica-se a