IValueConverter.Convert(Object, TypeName, Object, String) Methode

Referenz

Definition

Namespace:: Windows.UI.Xaml.Data

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Ändert die Quelldaten, bevor sie zur Anzeige auf der Benutzeroberfläche an das Ziel übergeben werden.

public:
 Platform::Object ^ Convert(Platform::Object ^ value, TypeName targetType, Platform::Object ^ parameter, Platform::String ^ language);

IInspectable Convert(IInspectable const& value, TypeName const& targetType, IInspectable const& parameter, winrt::hstring const& language);

public object Convert(object value, System.Type targetType, object parameter, string language);

function convert(value, targetType, parameter, language)

Public Function Convert (value As Object, targetType As Type, parameter As Object, language As String) As Object

Parameter

value: Object
Platform::Object

IInspectable

Die Quelldaten, die an das Ziel übergeben werden.

targetType: TypeName Type

Der Typ der Zieleigenschaft als Typverweis (System.Type für Microsoft .NET, eine TypeName-Hilfsstruktur für C++/CX und C++/WinRT).

parameter: Object
Platform::Object

IInspectable

Ein optionaler Parameter, der in der Konverterlogik verwendet werden soll.

language: String
Platform::String

winrt::hstring

Die Sprache der Konvertierung.

Gibt zurück

Object

Platform::Object

IInspectable

Der Wert, der an die Zielabhängigkeitseigenschaft übergeben werden soll.

Beispiele

Im folgenden Beispiel wird gezeigt, wie die Convert-Methode mithilfe des Parameters und der Sprachparameter implementiert wird.

//
// MainPage.xaml.h
// Declaration of the MainPage class.
// 

#pragma once

#include "MainPage.g.h"

namespace IValueConverterExample
{

    // Simple business object.
    [Windows::UI::Xaml::Data::Bindable]
    public ref class Recording sealed 
    {
    public: 
        Recording (Platform::String^ artistName, Platform::String^ cdName, Windows::Foundation::DateTime release)
        {
            Artist = artistName;
            Name = cdName;
            ReleaseDate = release;
        }
        property Platform::String^ Artist;
        property Platform::String^ Name;
        property Windows::Foundation::DateTime ReleaseDate;
    };

    public ref class DateFormatter  sealed : Windows::UI::Xaml::Data::IValueConverter 
    {
        // This converts the DateTime object to the Platform::String^ to display.
    public:
        virtual Platform::Object^ Convert(Platform::Object^ value, Windows::UI::Xaml::Interop::TypeName targetType, 
            Platform::Object^ parameter, Platform::String^ language)
        {
            Windows::Foundation::DateTime dt = safe_cast<Windows::Foundation::DateTime>(value); 
            Windows::Globalization::DateTimeFormatting::DateTimeFormatter^ dtf =
                Windows::Globalization::DateTimeFormatting::DateTimeFormatter::ShortDate;
            return dtf->Format(dt); 
        }

        // No need to implement converting back on a one-way binding 
        virtual Platform::Object^ ConvertBack(Platform::Object^ value, Windows::UI::Xaml::Interop::TypeName targetType, 
            Platform::Object^ parameter, Platform::String^ language)
        {
            throw ref new Platform::NotImplementedException();
        }
    };

    /// <summary>
    /// An empty page that can be used on its own or navigated to within a Frame.
    /// </summary>
    public ref class MainPage sealed
    {
    public:
        MainPage()
        {	
            m_myMusic = ref new Platform::Collections::Vector<Recording^>();

            // Add items to the collection.

            // You can use a Calendar object to create a Windows::Foundation::DateTime
            auto c = ref new Windows::Globalization::Calendar();
            c->Year = 2008;
            c->Month = 2;
            c->Day = 5;
            m_myMusic->Append(ref new Recording("Chris Sells", "Chris Sells Live",
                c->GetDateTime()));

            c->Year = 2007;
            c->Month = 4;
            c->Day = 3;
            m_myMusic->Append(ref new Recording("Luka Abrus",
                "The Road to Redmond", c->GetDateTime()));
            
            c->Year = 2007;
            c->Month = 2;
            c->Day = 3;
            m_myMusic->Append(ref new Recording("Jim Hance",
                "The Best of Jim Hance", dt));
            InitializeComponent();

            // Set the data context for the combo box.
            MusicCombo->DataContext = m_myMusic;	
        }


    protected:
        virtual void OnNavigatedTo(Windows::UI::Xaml::Navigation::NavigationEventArgs^ e) override;

    private:
        Windows::Foundation::Collections::IVector<Recording^>^ m_myMusic;
    };
}

using System;
using System.Collections.ObjectModel;
using System.Globalization;
using Windows.UI.Xaml.Controls;
using Windows.UI.Xaml.Data;

namespace ConverterParameterEx
{
    public partial class Page : UserControl
    {

        public ObservableCollection<Recording> MyMusic =
            new ObservableCollection<Recording>();
        public Page()
        {
            InitializeComponent();

            // Add items to the collection.
            MyMusic.Add(new Recording("Chris Sells", "Chris Sells Live",
                new DateTime(2008, 2, 5)));
            MyMusic.Add(new Recording("Luka Abrus",
                "The Road to Redmond", new DateTime(2007, 4, 3)));
            MyMusic.Add(new Recording("Jim Hance",
                "The Best of Jim Hance", new DateTime(2007, 2, 6)));

            // Set the data context for the combo box.
            MusicCombo.DataContext = MyMusic;
        }
    }

    // Simple business object.
    public class Recording
    {
        public Recording() { }
        public Recording(string artistName, string cdName, DateTime release)
        {
            Artist = artistName;
            Name = cdName;
            ReleaseDate = release;
        }
        public string Artist { get; set; }
        public string Name { get; set; }
        public DateTime ReleaseDate { get; set; }
    }

    public class DateFormatter : IValueConverter
    {
        // This converts the DateTime object to the string to display.
        public object Convert(object value, Type targetType, 
            object parameter, string language)
        {
            // Retrieve the format string and use it to format the value.
            string formatString = parameter as string;
            if (!string.IsNullOrEmpty(formatString))
            {
                return string.Format(
                    new CultureInfo(language), formatString, value);
            }
            // If the format string is null or empty, simply call ToString()
            // on the value.
            return value.ToString();
        }

        // No need to implement converting back on a one-way binding 
        public object ConvertBack(object value, Type targetType, 
            object parameter, string language)
        {
            throw new NotImplementedException();
        }
    }
}

Imports System.Collections.ObjectModel
Imports System.Windows.Data
Imports System.Globalization

Partial Public Class Page
    Inherits UserControl

    Public MyMusic As New ObservableCollection(Of Recording)()
    Public Sub New()
        InitializeComponent()

        ' Add items to the collection.
        MyMusic.Add(New Recording("Sheryl Crow", "Detours", New DateTime(2008, 2, 5)))
        MyMusic.Add(New Recording("Brandi Carlisle", "The Story", New DateTime(2007, 4, 3)))
        MyMusic.Add(New Recording("Patty Griffin", "Children Running Through", New DateTime(2007, 2, 6)))

        ' Set the data context for the combo box.
        MusicCombo.DataContext = MyMusic
    End Sub
End Class

' Simple business object. 
Public Class Recording
    Public Sub New()
    End Sub
    Public Sub New(ByVal artistName As String, ByVal cdName As String, _
       ByVal release As DateTime)
        Artist = artistName
        Name = cdName
        ReleaseDate = release
    End Sub
    Private artistValue As String
    Private nameValue As String
    Private releaseDateValue As DateTime
    Public Property Artist() As String
        Get
            Return artistValue
        End Get
        Set(ByVal value As String)
            artistValue = value
        End Set
    End Property
    Public Property Name() As String
        Get
            Return nameValue
        End Get
        Set(ByVal value As String)
            nameValue = value
        End Set
    End Property
    Public Property ReleaseDate() As DateTime
        Get
            Return releaseDateValue
        End Get
        Set(ByVal value As DateTime)
            releaseDateValue = value
        End Set
    End Property
End Class

Public Class DateFormatter
    Implements IValueConverter

    ' This converts the DateTime object to the string to display. 
    Public Function Convert(ByVal value As Object, ByVal targetType As Type, _
        ByVal parameter As Object, ByVal language As System.String) As Object _
        Implements IValueConverter.Convert

        ' Retrieve the format string and use it to format the value. 
        Dim formatString As String = TryCast(parameter, String)
        If Not String.IsNullOrEmpty(formatString) Then

            Return String.Format(New CultureInfo(language), formatString, value)
        End If

        ' If the format string is null or empty, simply call ToString() 
        ' on the value. 
        Return value.ToString()
    End Function

    ' No need to implement converting back on a one-way binding.
    Public Function ConvertBack(ByVal value As Object, ByVal targetType As Type, _
        ByVal parameter As Object, _
        ByVal language As System.String) As Object _
        Implements IValueConverter.ConvertBack
        Throw New NotImplementedException()
    End Function
End Class

Hinweise

Der targetType-Parameter der Convert-Methode verwendet verschiedene Techniken zum Melden der Typsysteminformationen, je nachdem, ob Sie mit Microsoft .NET oder C++ programmieren.

Für Microsoft .NET übergibt dieser Parameter eine instance des Typs System.Type.
Für C++/CX und C++/WinRT übergibt dieser Parameter einen TypeName-Strukturwert . TypeName::Kindenthält den einfachen Zeichenfolgennamen des Typs, ähnlich wie Microsoft . NET-.Type.Name Wenn der Konverter von der Bindungs-Engine aufgerufen wird, wird der targetType-Wert übergeben, indem der Eigenschaftentyp der Zielabhängigkeitseigenschaft gesucht wird. Sie können diesen Wert aus zwei Gründen in Ihrer Convert-Implementierung verwenden:
Ihr Konverter geht davon aus, dass er immer Objekte eines bestimmten Typs zurückgibt, und Sie möchten überprüfen, ob die Bindung, für die der Konverter aufgerufen wird, den Konverter ordnungsgemäß verwendet. Wenn dies nicht der Fall ist, können Sie einen Fallbackwert zurückgeben oder eine Ausnahme auslösen (siehe "Ausnahmen von Konvertern" weiter unten).
Ihr Konverter kann mehr als einen Typ zurückgeben, und Sie möchten, dass die Verwendung den Konverter darüber informiert, welchen Typ er zurückgeben soll. Sie könnten beispielsweise eine Objekt-zu-Objekt-Konvertierung und eine Objekt-in-Zeichenfolge-Konvertierung innerhalb desselben Konvertercodes implementieren.

Die Sprache stammt aus dem ConverterLanguage-Wert einer bestimmten Bindung, nicht aus Systemwerten. Daher sollten Sie erwarten, dass es sich um eine leere Zeichenfolge handeln kann.

der Parameter stammt aus dem ConverterParameter-Wert einer bestimmten Bindung und ist standardmäßig NULL . Wenn Ihr Konverter Parameter verwendet, um die Zurückgegebenen zu ändern, erfordert dies in der Regel eine Konvention, um zu überprüfen, was von der Bindung übergeben und vom Konverter verarbeitet wird. Eine gängige Konvention besteht darin, Zeichenfolgen zu übergeben, die Modi für Ihren Konverter benennen, die zu unterschiedlichen Rückgabewerten führen. Beispielsweise verfügen Sie möglicherweise über die Modi "Einfach" und "Ausführlich", die Zeichenfolgen unterschiedlicher Länge zurückgeben, die jeweils für die Anzeige in verschiedenen Steuerelementtypen und Layouts der Benutzeroberfläche geeignet sind.

Ausnahmen von Konvertern

Die Datenbindungs-Engine fängt keine Ausnahmen ab, die von einem vom Benutzer bereitgestellten Konverter ausgelöst werden. Jede Ausnahme, die von der Convert-Methode ausgelöst wird, oder alle uncauaught-Ausnahmen, die von Methoden ausgelöst werden, die von der Convert-Methode aufgerufen werden, werden als Laufzeitfehler behandelt. Wenn Sie den Konverter in Situationen verwenden, in denen die Bindung Fallbacks verwenden oder auf andere Weise vernünftige Ergebnisse anzeigen kann, selbst wenn ein Konvertierungsfehler auftritt, sollten Sie erwägen, dass ihr Konverter DependencyProperty.UnsetValue zurückgibt und keine Ausnahmen auslöst. DependencyProperty.UnsetValue ist ein Sentinelwert, der im Abhängigkeitseigenschaftensystem eine besondere Bedeutung hat, und Bindungen, die diesen Wert übergeben werden, verwenden FallbackValue.

Eine weitere Alternative zum Auslösen von Ausnahmen besteht darin, den ursprünglichen Wert unverändert zurückzugeben und die Bindung instance verarbeiten zu lassen, was sie mit diesem Wert tun könnte. In den meisten Fällen sind ui-Bindungen, die fehlschlagen, keine Fehlerfälle. Sie verwenden einfach nicht den Quellwert und verwenden stattdessen DependencyProperty.UnsetValue , um nichts anzuzeigen, oder es werden Fallbacks verwendet.

try/catch basierend auf einer Wertsetzung ist ein gängiges Implementierungsmuster für die Convert-Methode, aber Sie sollten aus den oben genannten Gründen nicht erneut starten.

Ein Beispiel, das zeigt, wie die Convert-Methode mithilfe des Parameters und der Sprachparameter implementiert wird, finden Sie unter der IValueConverter-Schnittstelle .

Gilt für: