Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
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.
.NET MAUI Community Toolkit