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)

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

المعلمات

الاسمالنوعالوصف
addedContentStringالمحتوى الذي تريد إلحاقه

الإرجاع

TextOutput - عنصر TextOutput نفسه، وهو مفيد لإنشاء سلاسل

clear()

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

الإرجاع

TextOutput - عنصر TextOutput نفسه، وهو مفيد لإنشاء سلاسل

downloadAsFile(filename)

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

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

المعلمات

الاسمالنوعالوصف
filenameStringاسم الملف الذي تريد إبلاغ المتصفّح باستخدامه

الإرجاع

TextOutput - عنصر TextOutput، وهو مفيد لإنشاء سلاسل

عمليات الرمي

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

getContent()

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

الإرجاع

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

getFileName()

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

الإرجاع

String: اسم الملف

getMimeType()

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

الإرجاع

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

setContent(content)

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

المعلمات

الاسمالنوعالوصف
contentStringالمحتوى المطلوب عرضه

الإرجاع

TextOutput - عنصر TextOutput نفسه، وهو مفيد لإنشاء سلاسل

setMimeType(mimeType)

لضبط نوع MIME للمحتوى الذي سيتم عرضه. الإعداد التلقائي هو النص العادي.

المعلمات

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

الإرجاع

TextOutput - عنصر TextOutput نفسه، وهو مفيد لإنشاء سلاسل