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 نفسه، وهو مفيد لإنشاء سلاسل