DateTimeOffsetConverter

DateTimeOffsetConverter to konwerter, który umożliwia użytkownikom konwertowanie DateTimeOffset na DateTime. Czasami wartość DateTime jest przechowywana wraz z przesunięciem w backendzie, aby zachować informację o strefie czasowej, z której pochodzi DateTime. Kontrolki takie jak Microsoft.Maui.Controls.DatePicker działają tylko z DateTime. Ten konwerter może być używany w tych scenariuszach.

Właściwości obiektu BaseConverter

Następujące właściwości są implementowane w klasie bazowej, public abstract class BaseConverter:

Majątek Description
DefaultConvertReturnValue Wartość domyślna, która ma być zwracana, gdy IValueConverter.Convert(object?, Type, object?, CultureInfo?) wyrzuca Exception. Ta wartość jest używana, gdy CommunityToolkit.Maui.Options.ShouldSuppressExceptionsInConverters jest ustawiona na wartość true.
DefaultConvertBackReturnValue Wartość domyślna, która ma być zwracana, gdy IValueConverter.ConvertBack(object?, Type, object?, CultureInfo?) wyrzuca Exception. Ta wartość jest używana, gdy CommunityToolkit.Maui.Options.ShouldSuppressExceptionsInConverters jest ustawiona na wartość true.

Właściwości ICommunityToolkitValueConverter

Następujące właściwości są implementowane w public interface ICommunityToolkitValueConverter:

Majątek Typ Description
DefaultConvertReturnValue object? Wartość domyślna, która ma być zwracana, gdy IValueConverter.Convert(object?, Type, object?, CultureInfo?) wyrzuca Exception. Ta wartość jest używana, gdy CommunityToolkit.Maui.Options.ShouldSuppressExceptionsInConverters jest ustawiona na wartość true.
DefaultConvertBackReturnValue object? Wartość domyślna, która ma być zwracana, gdy IValueConverter.ConvertBack(object?, Type, object?, CultureInfo?) wyrzuca Exception. Ta wartość jest używana, gdy CommunityToolkit.Maui.Options.ShouldSuppressExceptionsInConverters jest ustawiona na wartość true.

Syntax

XAML

Dołączanie przestrzeni nazw XAML

Aby można było używać zestawu narzędzi w języku XAML, należy dodać następujące xmlns elementy do strony lub widoku:

xmlns:toolkit="http://schemas.microsoft.com/dotnet/2022/maui/toolkit"

Zatem następujące:

<ContentPage
    x:Class="CommunityToolkit.Maui.Sample.Pages.MyPage"
    xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
    xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml">

</ContentPage>

Zostanie zmodyfikowana w celu uwzględnienia xmlns w następujący sposób:

<ContentPage
    x:Class="CommunityToolkit.Maui.Sample.Pages.MyPage"
    xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
    xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
    xmlns:toolkit="http://schemas.microsoft.com/dotnet/2022/maui/toolkit">

</ContentPage>

Korzystanie z elementu DateTimeOffsetConverter

DateTimeOffsetConverter można użyć w następujący sposób w języku XAML:

<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             xmlns:toolkit="http://schemas.microsoft.com/dotnet/2022/maui/toolkit"
             x:Class="MyLittleApp.MainPage">
    <ContentPage.Resources>
         <ResourceDictionary>
             <toolkit:DateTimeOffsetConverter x:Key="DateTimeOffsetConverter" />
         </ResourceDictionary>
    </ContentPage.Resources>

    <VerticalStackLayout>
            <Label Text="The DatePicker below is bound to a Property of type DateTimeOffset."
                   Margin="16"
                   HorizontalOptions="Center"
                   FontAttributes="Bold" />

            <DatePicker Date="{Binding TheDate, Converter={StaticResource DateTimeOffsetConverter}}" 
                   Margin="16"
                   HorizontalOptions="Center" />

            <Label Text="{Binding TheDate}"
                   Margin="16"
                   HorizontalOptions="Center"
                   FontAttributes="Bold" />
        </VerticalStackLayout>
</ContentPage>

C#

DateTimeOffsetConverter można użyć w następujący sposób w języku C#:

class DateTimeOffsetConverterPage : ContentPage
{
    public DateTimeOffsetConverterPage()
    {
        var label = new Label();

        label.SetBinding(
            Label.TextProperty,
            new Binding(
                static (ViewModels vm) => vm.MyValue,
                converter: new DateTimeOffsetConverter()));

        Content = label;
    }
}

Znaczniki języka C#

Nasz pakiet CommunityToolkit.Maui.Markup zapewnia znacznie bardziej zwięzły sposób używania tego konwertera w języku C#.

using CommunityToolkit.Maui.Markup;

class DateTimeOffsetConverterPage : ContentPage
{
    public DateTimeOffsetConverterPage()
    {
        Content = new Label()
            .Bind(
                Label.TextProperty,
                static (ViewModel vm) => vm.MyValue,
                converter: new DateTimeOffsetConverter());
    }
}

Examples

Przykład tego konwertera można znaleźć w .NET MAUI Community Toolkit Sample Application.

API

Kod źródłowy DateTimeOffsetConverter można znaleźć w repozytorium .NET MAUI Community Toolkit GitHub.