DataObject.GetData Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Restituisce i dati associati con il formato dati specificato.

Overload

GetData(String, Boolean)

Restituisce i dati associati al formato specificato, usando un parametro di conversione automatica per stabilire se convertirli nel formato.
GetData(String)

Restituisce i dati associati con il formato dati specificato.
GetData(Type)

Restituisce i dati associati al formato del tipo di classe specificato.

GetData(String, Boolean)

Restituisce i dati associati al formato specificato, usando un parametro di conversione automatica per stabilire se convertirli nel 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

Parametri

format
String

Formato dei dati da recuperare. Per i formati predefiniti, vedere DataFormats.

autoConvert
Boolean

true per convertire i dati nel formato specificato; in caso contrario, false.

Restituisce

Object

Dati associati al formato specificato, oppure null.

Implementazioni

GetData(String, Boolean)

Esempio

Nell'esempio di codice seguente vengono recuperati i dati archiviati in un DataObjectoggetto , usando il parametro per specificare se convertire il autoConvert formato dati.

Prima di tutto, viene creato un nuovo DataObject oggetto con i dati di testo. L'esempio tenta quindi di recuperare i dati, specificando il relativo formato come stringa e nessuna conversione di formato, ovvero il autoConvert parametro è false. Questa operazione ha esito negativo perché non sono presenti dati stringa nell'oggetto DataObject.

Successivamente, l'esempio tenta di recuperare di nuovo i dati, con il autoConvert parametro impostato su true. Questa operazione ha esito positivo e i risultati vengono visualizzati in un MessageBoxoggetto .

Questo codice richiede che textBox1 sia stato creato.

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

Commenti

Se il autoConvert parametro è true e questo metodo non riesce a trovare i dati nel formato specificato, tenta di convertire i dati nel formato. Se i dati non possono essere convertiti nel formato specificato o se i dati sono stati archiviati con la conversione automatica impostata su false, questo metodo restituisce null.

Se il autoConvert parametro è false, questo metodo restituisce i dati nel formato specificato oppure null se non è possibile trovare dati in questo formato.

Per determinare se i dati sono associati o possono essere convertiti in, un formato, chiamare prima di chiamare GetDataPresentGetData. Chiamare GetFormats un elenco di formati validi per i dati archiviati in questo DataObjectoggetto .

Nota

I dati possono essere convertiti in un altro formato se è stato archiviato specificando che la conversione è consentita e se il formato richiesto è compatibile con il formato archiviato. Ad esempio, i dati archiviati come Unicode possono essere convertiti in testo.

Quando format è Html, questo metodo restituisce una stringa codificata UTF-8 nelle applicazioni destinate a .NET 4.5 o versione successiva e una stringa con codifica ANSI nelle applicazioni destinate a .NET 4.0 o versioni successive.

Vedi anche

Si applica a

GetData(String)

Restituisce i dati associati con il formato dati specificato.

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

Parametri

format
String

Formato dei dati da recuperare. Per i formati predefiniti, vedere DataFormats.

Restituisce

Object

Dati associati al formato specificato, oppure null.

Implementazioni

GetData(String)

Esempio

Nell'esempio di codice seguente vengono recuperati i dati archiviati in un DataObjectoggetto . Prima di tutto, viene creato un nuovo DataObject oggetto con i dati di testo. I dati vengono quindi recuperati, specificando il relativo formato come stringa e visualizzati in una casella di testo.

Questo codice richiede che textBox1 sia stato creato.

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

Commenti

Se questo metodo non riesce a trovare i dati nel formato specificato, tenta di convertire i dati nel formato. Se i dati non possono essere convertiti nel formato specificato o se i dati sono stati archiviati con la conversione automatica impostata su false, questo metodo restituisce null.

Per determinare se i dati sono associati o possono essere convertiti in, un formato, chiamare prima di chiamare GetDataPresentGetData. Chiamare GetFormats un elenco di formati validi per i dati archiviati in questo DataObjectoggetto .

Nota

I dati possono essere convertiti in un altro formato se è stato archiviato specificando che la conversione è consentita e se il formato richiesto è compatibile con il formato archiviato. Ad esempio, i dati archiviati come Unicode possono essere convertiti in testo.

Quando format è Html, questo metodo restituisce una stringa codificata UTF-8 nelle applicazioni destinate a .NET 4.5 o versione successiva e una stringa con codifica ANSI nelle applicazioni destinate a .NET 4.0 o versioni successive.

Vedi anche

Si applica a

GetData(Type)

Restituisce i dati associati al formato del tipo di classe specificato.

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

Parametri

format
Type

Oggetto Type che rappresenta il formato dei dati da recuperare.

Restituisce

Object

Dati associati al formato specificato, oppure null.

Implementazioni

GetData(Type)

Esempio

Nell'esempio di codice seguente vengono recuperati i dati archiviati in un DataObjectoggetto . Prima di tutto, viene creato un nuovo DataObject oggetto con un componente. I dati vengono quindi recuperati, specificando il relativo tipo. Il tipo dei dati recuperati viene visualizzato in una casella di testo.

Questo codice richiede che textBox1 sia stato creato.

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

Commenti

Se questo metodo non riesce a trovare i dati nel formato specificato, tenta di convertire i dati nel formato. Se i dati non possono essere convertiti nel formato specificato o se i dati sono stati archiviati con la conversione automatica impostata su false, questo metodo restituisce null.

Per determinare se i dati sono associati o possono essere convertiti in, un formato, chiamare prima di chiamare GetDataPresentGetData. Chiamare GetFormats un elenco di formati validi per i dati archiviati in questo DataObjectoggetto .

Nota

I dati possono essere convertiti in un altro formato se è stato archiviato specificando che la conversione è consentita e se il formato richiesto è compatibile con il formato archiviato. Ad esempio, i dati archiviati come Unicode possono essere convertiti in testo.

Vedi anche

Si applica a