Syntax

binary(
    name: "hello.txt",
    data: "Hello World!",
    contentType: "text/plain",
    encoding: "utf-8"
)

Beschreibung

Konstruiert einen binären Wert (eine Datei) mit den angegebenen Werten. Ein solcher Wert kann in einem Attribut vom Typ tl.core:Binary gespeichert und zum Download angeboten werden.

Parameter

Name	Typ	Beschreibung	Pflicht	Default
name	Zeichenkette	Name der Datei	ja	-/-
data	Any	Dateiinhalt. Wenn der Wert ist selbst ein binärer Wert ist, wird dieser unverändert übernommen. Wenn der Inhaltstyp "application/json" ist, wird eine JSON-Repräsentanz für das Objekt erzeugt. Ansonsten wird die String-Repräsentanz des Wertes verwendet und in dem angegebenen Zeichensatz gespeichert.	ja	-/-
contentType	Zeichenkette	MIME-Type der Datei, z.B. "text/plain" für eine Textdatei oder "application/json" für ein Objekt in JSON-Format.	nein	Wird aus dem Dateinamen abgeleitet.
encoding	Zeichenkette	Der zu verwendende Zeichensatz für textuellen Inhalt. Hat keine Bedeutung, bei anderem Inhalt.	nein	"utf-8"
size	Zahl	Länge der Binärdaten, -1, wenn nicht bekannt.	nein	-1

Rückgabewert

Typ: Binärwert

Eine Repräsentanz einer Datei. Im obigen Beispiel ist es eine Textdatei mit Namen "hello.txt" und dem Inhalt "Hello world!" kodiert in dem Zeichensatz "utf-8". Wird der Wert als Rückgabewert einer benutzerdefinierten Aktion eines Knopfes verwendet, werden die Daten dem Nutzer als Download angeboten.