DataObject.GetData Metoda

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í

Name	Description
GetData(String)	Zastaralé. Vrátí data přidružená k zadanému formátu dat.
GetData(Type)	Zastaralé. Vrátí data přidružená k zadanému formátu typu třídy.
GetData(String, Boolean)	Zastaralé. 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)

Zdroj:

DataObject.cs

Upozornění

DataObject.GetData methods are obsolete. Use the corresponding DataObject.TryGetData<T> instead.

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

public:
 virtual System::Object ^ GetData(System::String ^ format);

[System.Obsolete("`DataObject.GetData` methods are obsolete. Use the corresponding `DataObject.TryGetData<T>` instead.", false, DiagnosticId="WFDEV005", UrlFormat="https://aka.ms/winforms-warnings/{0}")]
public virtual object? GetData(string format);

[<System.Obsolete("`DataObject.GetData` methods are obsolete. Use the corresponding `DataObject.TryGetData<T>` instead.", false, DiagnosticId="WFDEV005", UrlFormat="https://aka.ms/winforms-warnings/{0}")>]
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)

Atributy

ObsoleteAttribute

Příklady

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

Tento kód vyžaduje vytvoření textBox1 .

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 data uložena s automatickým převodem nastavena na false, tato metoda vrátí null.

Chcete-li zjistit, zda jsou data přidružena nebo lze převést na formát, volání GetDataPresent před voláním GetData. Volání GetFormats seznamu platných formátů pro data uložená v tomto DataObjectsouboru .

Note

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

Pokud je formatHtml, vrátí tato metoda řetězec kódování 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í .NET 4.0 nebo nižší.

Viz také

• SetData(String, Boolean, Object)
• GetDataPresent(Type)
• DataFormats
• GetFormats(Boolean)

GetData(Type)

Zdroj:

DataObject.cs

Upozornění

DataObject.GetData methods are obsolete. Use the corresponding DataObject.TryGetData<T> instead.

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

public:
 virtual System::Object ^ GetData(Type ^ format);

[System.Obsolete("`DataObject.GetData` methods are obsolete. Use the corresponding `DataObject.TryGetData<T>` instead.", false, DiagnosticId="WFDEV005", UrlFormat="https://aka.ms/winforms-warnings/{0}")]
public virtual object? GetData(Type format);

[<System.Obsolete("`DataObject.GetData` methods are obsolete. Use the corresponding `DataObject.TryGetData<T>` instead.", false, DiagnosticId="WFDEV005", UrlFormat="https://aka.ms/winforms-warnings/{0}")>]
abstract member GetData : Type -> obj
override this.GetData : Type -> obj

Public Overridable Function GetData (format As Type) As Object

Parametry

format

Type

Představuje Type formát dat, který se má načíst.

Návraty

Object

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

Implementuje

GetData(Type)

Atributy

ObsoleteAttribute

Příklady

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

Tento kód vyžaduje vytvoření textBox1 .

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 data uložena s automatickým převodem nastavena na false, tato metoda vrátí null.

Chcete-li zjistit, zda jsou data přidružena nebo lze převést na formát, volání GetDataPresent před voláním GetData. Volání GetFormats seznamu platných formátů pro data uložená v tomto DataObjectsouboru .

Note

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

Viz také

• SetData(String, Boolean, Object)
• Type
• GetDataPresent(Type)
• DataFormats
• GetFormats(Boolean)

GetData(String, Boolean)

Zdroj:

DataObject.cs

Upozornění

DataObject.GetData methods are obsolete. Use the corresponding DataObject.TryGetData<T> instead.

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);

[System.Obsolete("`DataObject.GetData` methods are obsolete. Use the corresponding `DataObject.TryGetData<T>` instead.", false, DiagnosticId="WFDEV005", UrlFormat="https://aka.ms/winforms-warnings/{0}")]
public virtual object? GetData(string format, bool autoConvert);

[<System.Obsolete("`DataObject.GetData` methods are obsolete. Use the corresponding `DataObject.TryGetData<T>` instead.", false, DiagnosticId="WFDEV005", UrlFormat="https://aka.ms/winforms-warnings/{0}")>]
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

truepřevést data 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)

Atributy

ObsoleteAttribute

Příklady

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

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

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

Tento kód vyžaduje vytvoření textBox1 .

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

autoConvert Pokud je true parametr 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 nastavena na false, tato metoda vrátí null.

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

Chcete-li zjistit, zda jsou data přidružena nebo lze převést na formát, volání GetDataPresent před voláním GetData. Volání GetFormats seznamu platných formátů pro data uložená v tomto DataObjectsouboru .

Note

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

Pokud je formatHtml, vrátí tato metoda řetězec kódování 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í .NET 4.0 nebo nižší.

Viz také

• SetData(String, Boolean, Object)
• GetDataPresent(Type)
• DataFormats
• GetFormats(Boolean)