Diagramm: BildChart: Image

Namespace: microsoft.graphNamespace: microsoft.graph

Rendert das Diagramm als base64-codiertes Bild durch Skalierung, um es an die angegebenen Maße anzupassen.Renders the chart as a base64-encoded image by scaling the chart to fit the specified dimensions.

BerechtigungenPermissions

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie im Artikel zum Thema Berechtigungen.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

BerechtigungstypPermission type Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)Permissions (from least to most privileged)
Delegiert (Geschäfts-, Schul- oder Unikonto)Delegated (work or school account) Files.ReadWriteFiles.ReadWrite
Delegiert (persönliches Microsoft-Konto)Delegated (personal Microsoft account) Nicht unterstütztNot supported.
AnwendungApplication Nicht unterstütztNot supported.

HTTP-AnforderungHTTP request

GET /workbook/worksheets/{id|name}/charts/{name}/image
GET /workbook/worksheets/{id|name}/charts/{name}/image(width=640)
GET /workbook/worksheets/{id|name}/charts/{name}/image(width=640,height=480)
GET /workbook/worksheets/{id|name}/charts/{name}/image(width=640,height=480,fittingMode='fit')

AnforderungsheaderRequest headers

NameName BeschreibungDescription
AuthorizationAuthorization Bearer {token}. Erforderlich.Bearer {token}. Required.
Arbeitsmappensitzungs-IDWorkbook-Session-Id Arbeitsmappensitzungs-ID, die bestimmt, ob Änderungen beibehalten werden. Optional.Workbook session Id that determines if changes are persisted or not. Optional.

PfadparameterPath parameters

Geben Sie im Anforderungstext ein JSON-Objekt mit den folgenden Parametern an.In the request body, provide a JSON object with the following parameters.

ParameterParameter TypType BeschreibungDescription
heightheight Int32Int32 Die gewünschte Höhe des resultierenden Bilds.The desired height of the resulting image. Optional.Optional.
widthwidth Int32Int32 Die gewünschte Breite des resultierenden Bilds.The desired width of the resulting image. Optional.Optional.
fittingModefittingMode stringstring Die Methode, mit der das Diagramm auf die angegebenen Dimensionen skaliert wird (wenn Höhe und Breite festgelegt sind).The method used to scale the chart to the specified dimensions (if both height and width are set)." Die möglichen Werte sind: Fit, FitAndCenter, Fill.The possible values are: Fit, FitAndCenter, Fill.

AntwortResponse

Wenn die Methode erfolgreich verläuft, werden der Antwortcode 200 OK und eine base64-Bildzeichenfolge im Antworttext zurückgegeben.If successful, this method returns 200 OK response code and base-64 image string in the response body.

BeispielExample

Nachfolgend sehen Sie ein Beispiel dafür, wie diese API aufgerufen wird.Here is an example of how to call this API.

AnforderungRequest

Nachfolgend sehen Sie ein Beispiel der Anforderung.Here is an example of the request.

GET https://graph.microsoft.com/v1.0/me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/image(width=640,height=480,fittingMode='fit')
AntwortResponse

Nachfolgend sehen Sie ein Beispiel der Antwort. Hinweis: Das hier gezeigte Antwortobjekt ist möglicherweise aus Platzgründen abgeschnitten. Von einem tatsächlichen Aufruf werden alle Eigenschaften zurückgegeben.Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.

HTTP/1.1 200 OK
Content-type: application/json;odata.metadata=minimal;odata.streaming=true

{
"value" : "base-64 chart image string"
}

VerwendungUsage

Sie können die Base64-Zeichenfolge innerhalb eines HTML-Bild-Tags anzeigen: <img src="data:image/png;base64,{base-64 chart image string}/>.You can display the base-64 string inside an HTML image tag: <img src="data:image/png;base64,{base-64 chart image string}/>.

Verwenden Sie für das Standardverhalten Image(width=0,height=0,fittingMode='fit').For default behavior, use Image(width=0,height=0,fittingMode='fit'). Hier ist ein Beispiel für ein Diagrammbild, das mit den standardmäßigen Parametern zurückgegeben wird.Here is an example of a chart image returned with the default parameters.

Excel-Diagrammbild mit Standardhöhe und -breite.

Wenn Sie die Anzeige des Bilds anpassen möchten, geben Sie eine Höhe, Breite und einen Anpassmodus an.If you want to customize the display of the image, specify a height, width, and a fitting mode. So sieht dasselbe Diagrammbild aus, wenn Sie es mit diesen Parametern abrufen: Image(width=500,height=500,fittingMode='Fill').Here is what the same chart image looks like if you retrieve it with these parameters: Image(width=500,height=500,fittingMode='Fill').

Excel-Diagrammbild mit Standardhöhe und -breite.