Sdílet prostřednictvím

DataObject.GetData Metoda

  • Reference

Definice

Obor názvů:
System.Windows.Forms
Sestavení:
System.Windows.Forms.dll

Vrátí data přidružená k zadanému formátu dat.

Přetížení

GetData(String, Boolean)

Vrátí data přidružená k zadanému formátu dat pomocí parametru automatizovaného převodu k určení, zda se mají data převést do formátu.
GetData(String)

Vrátí data přidružená k zadanému formátu dat.
GetData(Type)

Vrátí data přidružená k zadanému formátu typu třídy.

GetData(String, Boolean)

Vrátí data přidružená k zadanému formátu dat pomocí parametru automatizovaného převodu k určení, zda se mají data převést do formátu.

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

Parametry

format
String

Formát dat, která se mají načíst. Viz DataFormats předdefinované formáty.

autoConvert
Boolean

truena převod dat do zadaného formátu; v opačném případě . false

Návraty

Object

Data přidružená k zadanému formátu nebo null.

Implementuje

GetData(String, Boolean)

Příklady

Následující příklad kódu načte data uložená DataObjectv souboru pomocí parametru autoConvert k určení, zda se má formát dat převést.

Nejprve se vytvoří nový DataObject s textovými daty. Pak se příklad pokusí načíst data a určí jejich formát jako řetězec a bez převodu autoConvert formátu, to znamená, že parametr je false. Tato operace selže, protože v souboru nejsou žádná řetězcová DataObjectdata.

V dalším kroku se příklad pokusí načíst data znovu s parametrem nastaveným autoConvert na true. Tato operace je úspěšná a výsledky se zobrazí v MessageBoxsouboru .

Tento kód vyžaduje, aby textBox1 byl vytvořen.

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

Poznámky

Pokud parametr autoConvert je true a tato metoda nemůže najít data v zadaném formátu, pokusí se převést data do formátu. Pokud data nelze převést do zadaného formátu nebo pokud byla data uložena s automatickým převodem nastaveným na false, vrátí nulltato metoda .

autoConvert Pokud je falseparametr , vrátí tato metoda data v zadaném formátu nebo null pokud nelze najít žádná data v tomto formátu.

Pokud chcete zjistit, jestli jsou data přidružená k formátu nebo zda je lze převést na, zavolejte před GetDataPresent voláním GetDatapříkazu . Volání GetFormats seznamu platných formátů pro data uložená v tomto DataObjectsouboru

Poznámka

Data lze převést do jiného formátu, pokud byla uložena s určením, že převod je povolen a požadovaný formát je kompatibilní s uloženým formátem. Například data uložená jako Unicode se dají převést na text.

Pokud format je Html, vrátí tato metoda řetězec kódovaný UTF-8 v aplikacích, které cílí na .NET 4.5 nebo vyšší, a řetězec kódovaný ANSI v aplikacích, které cílí na .NET 4.0 nebo nižší.

Viz také

Platí pro

GetData(String)

Vrátí data přidružená k zadanému formátu dat.

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

Parametry

format
String

Formát dat, která se mají načíst. Viz DataFormats předdefinované formáty.

Návraty

Object

Data přidružená k zadanému formátu nebo null.

Implementuje

GetData(String)

Příklady

Následující příklad kódu načte data uložená DataObjectv souboru . Nejprve se vytvoří nový DataObject s textovými daty. Potom se data načtou, určí se jejich formát jako řetězec a zobrazí se v textovém poli.

Tento kód vyžaduje, aby textBox1 byl vytvořen.

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

Poznámky

Pokud tato metoda nemůže najít data v zadaném formátu, pokusí se převést data do formátu. Pokud data nelze převést do zadaného formátu nebo pokud byla uložena s automatickým převodem nastaveným na false, vrátí nulltato metoda .

Pokud chcete zjistit, jestli jsou data přidružená k formátu nebo zda je lze převést na, zavolejte před GetDataPresent voláním GetDatapříkazu . Volání GetFormats seznamu platných formátů pro data uložená v tomto DataObjectsouboru

Poznámka

Data lze převést do jiného formátu, pokud byla uložena s určením, že převod je povolen a požadovaný formát je kompatibilní s uloženým formátem. Například data uložená jako Unicode se dají převést na text.

Pokud format je Html, vrátí tato metoda řetězec kódovaný UTF-8 v aplikacích, které cílí na .NET 4.5 nebo vyšší, a řetězec kódovaný ANSI v aplikacích, které cílí na .NET 4.0 nebo nižší.

Viz také

Platí pro

GetData(Type)

Vrátí data přidružená k zadanému formátu typu třídy.

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

Parametry

format
Type

A Type představující formát dat, která se mají načíst.

Návraty

Object

Data přidružená k zadanému formátu nebo null.

Implementuje

GetData(Type)

Příklady

Následující příklad kódu načte data uložená DataObjectv souboru . Nejprve se vytvoří nový DataObject s komponentou. Potom se data načtou a určí se jejich typ. Typ načtených dat se zobrazí v textovém poli.

Tento kód vyžaduje, aby textBox1 byl vytvořen.

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

Poznámky

Pokud tato metoda nemůže najít data v zadaném formátu, pokusí se převést data do formátu. Pokud data nelze převést do zadaného formátu nebo pokud byla uložena s automatickým převodem nastaveným na false, vrátí nulltato metoda .

Pokud chcete zjistit, jestli jsou data přidružená k formátu nebo zda je lze převést na, zavolejte před GetDataPresent voláním GetDatapříkazu . Volání GetFormats seznamu platných formátů pro data uložená v tomto DataObjectsouboru

Poznámka

Data lze převést do jiného formátu, pokud byla uložena s určením, že převod je povolen a požadovaný formát je kompatibilní s uloženým formátem. Například data uložená jako Unicode se dají převést na text.

Viz také

Platí pro