تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Class TextOutput

كائن TextOutput الذي يمكن عرضه من نص برمجي

نظرًا لاعتبارات أمنية، لا يمكن للنصوص البرمجية أن تعرض المحتوى النصي مباشرةً إلى المتصفح. بدلاً من ذلك، تتم إعادة توجيه المتصفح إلى googleusercontent.com، والذي سيعرضه بدون أي موقع لمزيد من التطهير أو التلاعب.

يمكنك عرض محتوى نصي كما يلي:

function doGet() {
  return ContentService.createTextOutput("hello world!");
}

وهناك أيضًا طرق لعرض JSON وRSS وXML كمخرجات نصية، اطّلِع على الطرق المقابلة في ContentService.

الطُرق

الطريقة	نوع الإرجاع	وصف قصير
`append(addedContent)`	`TextOutput`	لإلحاق محتوى جديد بالمحتوى الذي سيتم عرضه
`clear()`	`TextOutput`	يؤدي هذا الإجراء إلى محو المحتوى الحالي.
`downloadAsFile(filename)`	`TextOutput`	تطلب هذه السياسة من المتصفّحات تنزيل هذا المحتوى بدلاً من عرضه.
`getContent()`	`String`	يحصل على المحتوى الذي سيتم عرضه.
`getFileName()`	`String`	عرض اسم الملف لتنزيل هذا الملف بتنسيق، أو "فارغ" إذا كان يجب عرضه بدلاً من تم تنزيله.
`getMimeType()`	`MimeType`	احصل على نوع MIME الذي سيتم عرض هذا المحتوى من خلاله.
`setContent(content)`	`TextOutput`	لتعيين المحتوى الذي سيتم عرضه.
`setMimeType(mimeType)`	`TextOutput`	تُحدِّد نوع MIME للمحتوى الذي سيتم عرضه.

الوثائق التفصيلية

`append(addedContent)`

لإلحاق محتوى جديد بالمحتوى الذي سيتم عرضه

المعلمات

الاسم	النوع	الوصف
`addedContent`	`String`	المحتوى لإلحاقه

الإرجاع

TextOutput — أداة TextOutput هذه نفسها، وهي مفيدة للتسلسل

`clear()`

يؤدي هذا الإجراء إلى محو المحتوى الحالي.

الإرجاع

TextOutput — أداة TextOutput هذه نفسها، وهي مفيدة للتسلسل

`downloadAsFile(filename)`

تطلب هذه السياسة من المتصفّحات تنزيل هذا المحتوى بدلاً من عرضه.

وستتجاهل بعض المتصفِّحات هذا الإعداد. ويؤدي تعيين هذا على قيمة خالية إلى محوه مرة أخرى إلى السلوك الافتراضي للعرض بدلاً من التنزيل.

المعلمات

الاسم	النوع	الوصف
`filename`	`String`	اسم الملف لإبلاغ المتصفح باستخدام

الإرجاع

TextOutput: الكائن TextOutput، وهو مفيد للتسلسل

الرميات

Error: إذا كان اسم الملف يحتوي على أحرف غير مقبولة

`getContent()`

يحصل على المحتوى الذي سيتم عرضه.

الإرجاع

String - المحتوى الذي سيتم عرضه

`getFileName()`

عرض اسم الملف لتنزيل هذا الملف بتنسيق، أو "فارغ" إذا كان يجب عرضه بدلاً من تم تنزيله.

الإرجاع

String - اسم الملف

`getMimeType()`

احصل على نوع MIME الذي سيتم عرض هذا المحتوى من خلاله.

الإرجاع

MimeType — نوع MIME الذي سيتم تقديم هذا معه

`setContent(content)`

لتعيين المحتوى الذي سيتم عرضه.

المعلمات

الاسم	النوع	الوصف
`content`	`String`	المحتوى لعرض

الإرجاع

TextOutput — أداة TextOutput هذه نفسها، وهي مفيدة للتسلسل

`setMimeType(mimeType)`

تُحدِّد نوع MIME للمحتوى الذي سيتم عرضه. ويكون النص العادي التلقائي هو النص العادي.

المعلمات

الاسم	النوع	الوصف
`mimeType`	`MimeType`	نوع MIME

الإرجاع

TextOutput — أداة TextOutput هذه نفسها، وهي مفيدة للتسلسل