Beispiel: Festlegen und Abrufen von Entitätsbildern

Dieses Beispiel zeigt, wie Daten für Entitätsbilder eingerichtet und abgerufen werden. Sie können das Beispiel von hier herunterladen.

Notiz

Dieses Beispiel trifft auf Dynamics 365 Customer Engagement (on-premises) und Dataverse zu.

Wie man dieses Beispiel ausführt

Um eine lokale Kopie aller Muster zu erhalten und diese zu erstellen, gehen Sie wie folgt vor:

1. Um eine lokale Kopie zu erhalten, laden Sie das Beispiele-Repository herunter, oder klonen Sie es.
2. (Optional) Bearbeiten Sie die dataverse/App.config-Datei so, dass sie eine Verbindungszeichenfolge festlegt, aus der die Instanz/Organisation hervorgeht, zu der Sie eine Verbindung herstellen möchten.
3. Um das Beispiel auszuführen, öffnen Sie die Beispiellösung in Visual Studio, und drücken Sie F5. Nachdem Sie in der dataverse/App.config-Datei eine Verbindungszeichenfolge angegeben haben, nutzen alle Beispiele, die Sie ausführen, diese Verbindungsdaten.

Wenn Sie in der dataverse/App.config-Datei keine Verbindungszeichenfolge angeben, wird bei jeder Ausführung eines Beispiels ein Dialogfeld geöffnet, in dem Sie eingeben müssen, zu welcher Instanz oder Organisation Sie eine Verbindung herstellen und welche Anmeldeinformationen Sie verwenden möchten. Dieses Dialogfeld speichert frühere Verbindungen, so dass Sie eine bereits verwendete Verbindung auswählen können.

Funktionsweise

Dieses Beispiel zeigt, wie Daten für Entitätsbilder eingerichtet und abgerufen werden.

Wie dieses Beispiel funktioniert

Um das unter Was macht dieses Beispiel, beschriebene Szenario zu simulieren, geht das Beispiel wie folgt vor:

Einrichtung

Prüft die aktuelle Version der Organisation.

Demonstrieren

1. Nutzen Sie die CreateImageAttributeDemoEntity Methode, um eine benutzerdefinierten Entität mit den Schemanamen sample_ImageAttributeDemo und eines primären Attributs mit dem Schemanamen sample_Name zu erstellen.

2. Erstellen eines Bildattributs mit dem Schemanamen EntityImage. Alle Bildattribute verwenden diesen Namen.

3. Rufen Sie das Hauptformular für die sample_ImageAttributeDemo Entität ab, und legen Sie das showImage auf „true“ fest, damit das Bild in dem Formular angezeigt wird.

4. Veröffentlichen der sample_ImageAttributeDemo-Entität.

5. Erstellt fünf neue Datensätze für die sample_ImageAttributeDemo Entität mihilfe von fünf unterschiedlich großen Bilder, die sich im Bildordner befinden wie hier abgebildet. Nachdem jeder Datensatz erstellt ist, haben Sie die Chance, den Datensatz im Webbroser mithilfe der ShowEntityFormInBrowser Methode anzuzeigen, damit Sie sehen können, wie die Größe der Quellbilder an den verfügbaren Platz im Formular angepasst wird.

6. Ruft die Datensätze mit dem entityimage-Attribut ab und speichert die Dateien mit der veränderten Größe. Nachdem Sie sich das Beispiel ausgeführt haben, können Sie die Dateien im \bin\Debug-Ordner finden.

7. Ruft die Datensätze mit dem Attribut entityimage_url ab und zeigt die Werte der relativen URL an, die in der Anwendung eingeschlossen werden können, um auf die Bilder zuzugreifen. Diese Abfrage sollte besser reagieren, da die Menge der übertragenen Daten geringer ist.

Bereinigung

Zeigt eine Option an, um die Datensätze in Einrichtung zu löschen. Das Löschen ist optional, falls Sie die Entitäten und Daten durchsuchen möchten, die durch das Beispiel erstellt wurden. Sie können die Datensätze manuell löschen, um das gleiche Ergebnis zu erzielen.