Freigeben über

GravatarImageSource

  • Artikel

Ein Gravatar (ein „global anerkannter Avatar“) ist ein Bild, das auf mehreren Websites als Avatar verwendet werden kann , d. h. ein Bild, das Sie darstellt. Ein Gravatar kann beispielsweise eine Person in einem Forumbeitrag, in einem Blogkommentar usw. identifizieren. (Sie können Ihren eigenen Gravatar auf der Gravatar-Website unter http://www.gravatar.com/ registrieren.) Wenn Sie Bilder neben den Namen oder E-Mail-Adressen von Personen anzeigen möchten, können Sie GravatarImageSource verwenden.

Syntax

Einbinden des XAML-Namespace

Um das Toolkit in XAML verwenden zu können, muss der folgende xmlns-Abschnitt zu Ihrer Seite oder Ansicht hinzugefügt werden:

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

Der folgende Abschnitt:

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

Würde dann geändert werden, um xmlns einzubinden:

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

Verwenden von GravatarImageSource

Das folgende Beispiel zeigt die Verwendung von GravatarImageSource:

<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">
    <VerticalStackLayout>
        <Image>
            <Image.Source>
                <toolkit:GravatarImageSource
                    CacheValidity="1"
                    CachingEnabled="True"
                    Email="youremail@here.com"
                    Image="MysteryPerson" />
            </Image.Source>
        </Image>
    </VerticalStackLayout>
</ContentPage>

Der entsprechende C#-Code lautet:

using CommunityToolkit.Maui.ImageSources;

partial class MyPage : ContentPage
{
	public MyPage()
	{
        Image myImage = new()
        {
            Source = new GravatarImageSource()
            {
                CacheValidity = TimeSpan.FromDays(1),
                CachingEnabled = true,
                Email = "youremail@here.com",
                Image= DefaultImage.MysteryPerson
            },
        };
		Content = myImage;
	}
}

Eigenschaften

Eigenschaft Typ Beschreibung
CacheValidity TimeSpan Die Eigenschaft CacheValidity vom Typ TimeSpan gibt an, wie lange das Bild lokal gespeichert wird. Der Standardwert für diese Eigenschaft ist 1 Tag.
CachingEnabled bool Die Eigenschaft CachingEnabled vom Typ bool definiert, ob das Zwischenspeichern von Bildern aktiviert ist. Der Standardwert dieser Eigenschaft ist true.
E‑Mail string? Die Eigenschaft Email vom Typ string? gibt die E-Mail-Adresse des Gravatar-Kontos an. Wenn sie nicht festgelegt ist, wird das Gravatar-Bild gerendert. Wenn das Gravatar-Bild festgelegt und auf Gravatar nicht gefunden wird, wird das Image-Eigenschaftenbild gerendert.
Abbildung DefaultImage Die Eigenschaft Image vom Typ DefaultImage ist eine Aufzählung, die verwendet wird, um das Standardbild anzugeben, wenn email in Gravatar nicht gefunden wird.

Diese Eigenschaften werden durch BindableProperty-Objekte gestützt, was bedeutet, dass sie Ziele von Datenbindungen sein und formatiert werden können.

Festlegen der Cachegültigkeit

Die Eigenschaft CacheValidity ist ein TimeSpan-Wert, der angibt, wie lange das Bild lokal gespeichert wird.

Im folgenden Beispiel wird die Cachegültigkeit eines GravatarImageSource-Objekts festgelegt:

<Image>
    <Image.Source>
        <toolkit:GravatarImageSource CacheValidity="1" />
    </Image.Source>
</Image>

Der entsprechende C#-Code lautet:

Image myImage = new()
{
    Source = new GravatarImageSource()
    {
        CacheValidity = TimeSpan.FromDays(1),
    },
};

Aktivieren der Zwischenspeicherung

Die Eigenschaft CachingEnabled ist ein bool-Wert, der definiert, ob das Zwischenspeichern von Bildern aktiviert ist.

Im folgenden Beispiel wird festgelegt, dass die Zwischenspeicherung für ein GravatarImageSource-Objekt aktiviert ist:

<Image>
    <Image.Source>
        <toolkit:GravatarImageSource CachingEnabled="True" />
    </Image.Source>
</Image>

Der entsprechende C#-Code lautet:

Image myImage = new()
{
    Source = new GravatarImageSource()
    {
        CachingEnabled = true,
    },
};

Festlegen der E-Mail

Die Eigenschaft Email ist ein string-Wert, für den Nullwerte zulässig sind. Wenn die Eigenschaft null oder leer ist, wird das standardmäßige Gravatar-Bild gerendert. Wenn für die E-Mail-Adresse kein passendes Gravatar-Bild vorhanden ist, wird das Image-Eigenschaftenbild gerendert.

Im folgenden Beispiel wird eine E-Mail-Adresse festgelegt, zu der ein passendes Gravatar-Bild gehört:

<Image>
    <Image.Source>
        <toolkit:GravatarImageSource Email="dsiegel@avantipoint.com" />
    </Image.Source>
</Image>

Der entsprechende C#-Code lautet:

Image myImage = new()
{
    Source = new GravatarImageSource()
    {
        Email = "dsiegel@avantipoint.com",
    },
};

Im folgenden Beispiel wird keine E-Mail-Adresse festgelegt und daher das standardmäßige Gravatar-Bild angezeigt.

<Image>
    <Image.Source>
        <toolkit:GravatarImageSource />
    </Image.Source>
</Image>

Der entsprechende C#-Code lautet:

Image myImage = new()
{
    Source = new GravatarImageSource(),
};

Im folgenden Beispiel wird eine E-Mail-Adresse festgelegt, zu der kein passendes Gravatar-Bild gehört, und deshalb wird das Standardbild von Image anzeigt.

<Image>
    <Image.Source>
        <toolkit:GravatarImageSource Email="notregistered@emailongravitar.com" />
    </Image.Source>
</Image>

Der entsprechende C#-Code lautet:

Image myImage = new()
{
    Source = new GravatarImageSource()
    {
        Email = "notregistered@emailongravitar.com",
    },
};

Festlegen des Standardbilds

Die Eigenschaft Image ist eine Aufzählung, die verwendet wird, um das Standardbild anzugeben, wenn die email-Adresse kein passendes Gravatar-Bild aufweist. Verfügbare Optionen:

  • MysteryPerson (Standard): Ein einfacher, cartoonartiger Umriss einer Person (variiert nicht je nach E-Mail-Hash)
  • FileNotFound: Kein Bild laden, wenn dem E-Mail-Hash keines zugeordnet ist, sondern eine HTTP 404-Antwort (Datei nicht gefunden) zurückgeben.
  • Identicon: Ein geometrisches Muster, das auf einem E-Mail-Hash basiert.
  • MonsterId: Ein generiertes „Monster“ mit verschiedenen Farben, Gesichtern usw.
  • Wavatar: Generierte Gesichter mit unterschiedlichen Features und Hintergründen.
  • Retro: Fantastisch generierte, verpixelte Gesichter im 8-Bit-Arcade-Stil.
  • Robohash: Ein generierter Roboter mit verschiedenen Farben, Gesichtern usw.
  • Blank: Ein transparentes PNG-Bild.

Im folgenden Beispiel wird das Standardbild eines GravatarImageSource-Objekts festgelegt:

<Image>
    <Image.Source>
        <toolkit:GravatarImageSource Email="notregistered@emailongravitar.com" Image="Retro" />
    </Image.Source>
</Image>

Der entsprechende C#-Code lautet:

Image myImage = new()
{
    Source = new GravatarImageSource()
    {
        Email = "notregistered@emailongravitar.com",
        Image = DefaultImage.Retro
    },
};

Festlegen der Bildgröße

Stardmäßig werdenGravatarImageSource-Bilder mit einer Größe von 80px x 80px dargestellt. Die Bildgröße kann zwischen 1px und 2048px liegen und wird den Eigenschaften der übergeordneten Ansichtsgröße entnommen. Gravatar-Bilder sind quadratisch, und die größere der definierten Größeneigenschaften wird übernommen.

Im folgenden Beispiel wird die Größe des Bildsteuerelements festgelegt, und somit beträgt die Größe des angeforderten Gravatar-Bilds 73px.

<Image WidthRequest="72" HeightRequest="73">
    <Image.Source>
        <toolkit:GravatarImageSource Email="dsiegel@avantipoint.com" />
    </Image.Source>
</Image>

Der entsprechende C#-Code lautet:

Image myImage = new()
{
    Source = new GravatarImageSource()
    {
        Email = "dsiegel@avantipoint.com",
    },
    HeightRequest = 72,
    HeightRequest = 73,
};

Beispiele

Beispiele für dieses Steuerelement finden Sie in der .NET MAUI Community Toolkit-Beispielanwendung.

API

Sie finden den Quellcode für GravatarImageSource über das GitHub-Repository für das .NET MAUI Community Toolkit.