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)

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

المَعلمات

الاسمTypeالوصف
addedContentStringالمحتوى لإلحاقه

استرجاع الكرة

TextOutput - نتيجة النص هذه نفسها، وهي مفيدة للتسلسل


clear()

يؤدي ذلك إلى محو المحتوى الحالي.

استرجاع الكرة

TextOutput - نتيجة النص هذه نفسها، وهي مفيدة للتسلسل


downloadAsFile(filename)

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

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

المَعلمات

الاسمTypeالوصف
filenameStringاسم الملف لإخبار المتصفح باستخدام

استرجاع الكرة

TextOutput: كائن الإخراج النصي، وهو مفيد للتسلسل

الرميات

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


getContent()

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

استرجاع الكرة

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


getFileName()

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

استرجاع الكرة

String - اسم الملف


getMimeType()

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

استرجاع الكرة

MimeType - نوع MIME الذي سيتم العرض معه


setContent(content)

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

المَعلمات

الاسمTypeالوصف
contentStringالمحتوى للعرض

استرجاع الكرة

TextOutput - نتيجة النص هذه نفسها، وهي مفيدة للتسلسل


setMimeType(mimeType)

تحدِّد هذه السياسة نوع MIME للمحتوى الذي سيتم عرضه. الإعداد الافتراضي هو النص العادي.

المَعلمات

الاسمTypeالوصف
mimeTypeMimeTypeنوع MIME

استرجاع الكرة

TextOutput - نتيجة النص هذه نفسها، وهي مفيدة للتسلسل