Class UueArchive
Namespace: Aspose.Zip.Uue
Assembly: Aspose.Zip.dll (25.1.0)
คลาสนี้แทนไฟล์ที่ถูกเข้ารหัสด้วย uuencoded
public class UueArchive : IArchive, IDisposable, IArchiveFileEntryการสืบทอด
การนำไปใช้
IArchive, IDisposable, IArchiveFileEntry
สมาชิกที่สืบทอด
object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
ตัวสร้าง
UueArchive()
เริ่มต้นอินสแตนซ์ใหม่ของคลาส Aspose.Zip.Uue.UueArchive ที่เตรียมไว้สำหรับการเข้ารหัส
public UueArchive()ตัวอย่าง
ตัวอย่างต่อไปนี้แสดงวิธีการ uuencode ไฟล์
using (var archive = new UueArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.uue");
}UueArchive(Stream)
เริ่มต้นอินสแตนซ์ใหม่ของคลาส Aspose.Zip.Uue.UueArchive ที่เตรียมไว้สำหรับการถอดรหัส
public UueArchive(Stream sourceStream)พารามิเตอร์
sourceStream Stream
แหล่งที่มาของคลังข้อมูล
ตัวอย่าง
เปิดคลังข้อมูลจากสตรีมและแยกออกไปยัง MemoryStream
var ms = new MemoryStream();
using (var archive = new UueArchive(File.OpenRead("archive.001")))
archive.Open().CopyTo(ms);หมายเหตุ
ตัวสร้างนี้ไม่ถอดรหัส ดูเมธอด Aspose.Zip.Uue.UueArchive.Open สำหรับการบีบอัด
UueArchive(string)
เริ่มต้นอินสแตนซ์ใหม่ของคลาส Aspose.Zip.Uue.UueArchive
public UueArchive(string path)พารามิเตอร์
path string
เส้นทางไปยังไฟล์คลังข้อมูล
ตัวอย่าง
เปิดคลังข้อมูลจากไฟล์โดยเส้นทางและถอดรหัสไปยัง MemoryStream
var ms = new MemoryStream();
using (var archive = new UueArchive("archive.uue"))
archive.Open().CopyTo(ms);หมายเหตุ
ตัวสร้างนี้ไม่บีบอัด ดูเมธอด Aspose.Zip.Uue.UueArchive.Open สำหรับการบีบอัด
ข้อยกเว้น
path เป็น null
ผู้เรียกไม่มีสิทธิ์ที่จำเป็นในการเข้าถึง
path ว่างเปล่า มีเพียงช่องว่าง หรือมีอักขระที่ไม่ถูกต้อง
การเข้าถึงไฟล์ path ถูกปฏิเสธ
path ที่ระบุ ชื่อไฟล์ หรือทั้งสองเกินความยาวสูงสุดที่กำหนดโดยระบบ สำหรับตัวอย่าง บนแพลตฟอร์มที่ใช้ Windows เส้นทางต้องมีความยาวน้อยกว่า 248 อักขระ และชื่อไฟล์ต้องมีความยาวน้อยกว่า 260 อักขระ
ไฟล์ที่ path มีเครื่องหมายทวิภาค (:) อยู่กลางสตริง
คุณสมบัติ
Name
ชื่อของไฟล์ต้นฉบับ
public string Name { get; }ค่าของคุณสมบัติ
เมธอด
Dispose()
ดำเนินการตามงานที่กำหนดโดยแอปพลิเคชันที่เกี่ยวข้องกับการปล่อย ปลดปล่อย หรือรีเซ็ตทรัพยากรที่ไม่จัดการ
public void Dispose()Dispose(bool)
ดำเนินการตามงานที่กำหนดโดยแอปพลิเคชันที่เกี่ยวข้องกับการปล่อย ปลดปล่อย หรือรีเซ็ตทรัพยากรที่ไม่จัดการ
protected virtual void Dispose(bool disposing)พารามิเตอร์
disposing bool
ว่าทรัพยากรที่จัดการควรถูกปล่อย
Extract(Stream)
แยกคลังข้อมูลไปยังสตรีมที่ให้ไว้
public void Extract(Stream destination)พารามิเตอร์
destination Stream
สตรีมปลายทาง ต้องเขียนได้
ตัวอย่าง
using (var archive = new UueArchive("archive.uue"))
{
archive.Extract(httpResponseStream);
}ข้อยกเว้น
destination ไม่รองรับการเขียน
Extract(string)
แยกคลังข้อมูลไปยังไฟล์โดยเส้นทาง
public FileInfo Extract(string path)พารามิเตอร์
path string
เส้นทางไปยังไฟล์ปลายทาง หากไฟล์มีอยู่แล้ว จะถูกเขียนทับ
คืนค่า
ข้อมูลของไฟล์ที่ถูกแยก
ข้อยกเว้น
path เป็น null
ผู้เรียกไม่มีสิทธิ์ที่จำเป็นในการเข้าถึง
path ว่างเปล่า มีเพียงช่องว่าง หรือมีอักขระที่ไม่ถูกต้อง
การเข้าถึงไฟล์ path ถูกปฏิเสธ
path ที่ระบุ ชื่อไฟล์ หรือทั้งสองเกินความยาวสูงสุดที่กำหนดโดยระบบ สำหรับตัวอย่าง บนแพลตฟอร์มที่ใช้ Windows เส้นทางต้องมีความยาวน้อยกว่า 248 อักขระ และชื่อไฟล์ต้องมีความยาวน้อยกว่า 260 อักขระ
ไฟล์ที่ path มีเครื่องหมายทวิภาค (:) อยู่กลางสตริง
ไม่พบไฟล์
เส้นทางที่ระบุไม่ถูกต้อง เช่น อยู่บนไดรฟ์ที่ไม่ได้กำหนด
ไฟล์เปิดอยู่แล้ว
ExtractToDirectory(string)
แยกเนื้อหาของคลังข้อมูลไปยังไดเรกทอรีที่ให้ไว้
public void ExtractToDirectory(string destinationDirectory)พารามิเตอร์
destinationDirectory string
เส้นทางไปยังไดเรกทอรีที่จะวางไฟล์ที่ถูกแยกออกมา
หมายเหตุ
หากไดเรกทอรีไม่มีอยู่ จะถูกสร้างขึ้น
ข้อยกเว้น
destinationDirectory เป็น null
path ชื่อไฟล์ หรือทั้งสองเกินความยาวสูงสุดที่กำหนดโดยระบบ สำหรับตัวอย่าง บนแพลตฟอร์มที่ใช้ Windows เส้นทางต้องมีความยาวน้อยกว่า 248 อักขระ และชื่อไฟล์ต้องมีความยาวน้อยกว่า 260 อักขระ
ผู้เรียกไม่มีสิทธิ์ที่จำเป็นในการเข้าถึงไดเรกทอรีที่มีอยู่
หากไดเรกทอรีไม่มีอยู่ เส้นทางมีเครื่องหมายทวิภาค (:) ที่ไม่เป็นส่วนหนึ่งของป้ายชื่อไดรฟ์ (“C:")
destinationDirectory เป็นสตริงที่มีความยาวเป็นศูนย์ มีเพียงช่องว่าง หรือมีอักขระที่ไม่ถูกต้องหนึ่งตัวหรือมากกว่า คุณสามารถตรวจสอบอักขระที่ไม่ถูกต้องโดยใช้เมธอด System.IO.Path.GetInvalidPathChars
-หรือ- เส้นทางมีเครื่องหมายทวิภาค (:) เป็นส่วนเริ่มต้นหรือมีเพียงเครื่องหมายทวิภาคเท่านั้น
ไดเรกทอรีที่ระบุโดยเส้นทางเป็นไฟล์ หรือชื่อเครือข่ายไม่เป็นที่รู้จัก
Open()
เปิดคลังข้อมูลสำหรับการถอดรหัสและจัดเตรียมสตรีมที่มีเนื้อหาของคลังข้อมูล
public Stream Open()คืนค่า
สตรีมที่แทนเนื้อหาของคลังข้อมูล
ตัวอย่าง
การใช้งาน:
Stream decompressed = archive.Open();
.NET 4.0 ขึ้นไป - ใช้เมธอด Stream.CopyTo:
decompressed.CopyTo(httpResponse.OutputStream)
.NET 3.5 และก่อนหน้านี้ - คัดลอกไบต์ด้วยตนเอง:
byte[] buffer = new byte[8192];
int bytesRead;
while (0 < (bytesRead = decompressed.Read(buffer, 0, buffer.Length)))
fileStream.Write(buffer, 0, bytesRead);
```</p>
#### หมายเหตุ
อ่านจากสตรีมเพื่อรับเนื้อหาต้นฉบับของไฟล์ ดูส่วนตัวอย่าง
### <a id="Aspose_Zip_Uue_UueArchive_Save_System_IO_Stream_Aspose_Zip_Uue_UueSaveOptions_"></a> Save\(Stream, UueSaveOptions\)
บันทึกคลังข้อมูลไปยังสตรีมที่ให้ไว้
```csharp
public void Save(Stream outputStream, UueSaveOptions saveOptions = null)พารามิเตอร์
outputStream Stream
สตรีมปลายทาง
saveOptions UueSaveOptions
ตัวเลือกสำหรับการบันทึกคลังข้อมูล
ตัวอย่าง
เขียนข้อมูลที่ถูกบีบอัดไปยังสตรีมการตอบสนอง http
using (var archive = new UueArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save(httpResponse.OutputStream);
}หมายเหตุ
outputStream ต้องเขียนได้
ข้อยกเว้น
แหล่งข้อมูลที่ต้องการบีบอัดยังไม่ได้ถูกจัดเตรียม
outputStream ไม่สามารถเขียนได้
แหล่งไฟล์เป็นแบบอ่านอย่างเดียวหรือเป็นไดเรกทอรี
เส้นทางแหล่งไฟล์ที่ระบุไม่ถูกต้อง เช่น อยู่บนไดรฟ์ที่ไม่ได้กำหนด
แหล่งไฟล์เปิดอยู่แล้ว
Save(string, UueSaveOptions)
บันทึกคลังข้อมูลไปยังไฟล์ปลายทางที่ให้ไว้
public void Save(string destinationFileName, UueSaveOptions saveOptions = null)พารามิเตอร์
destinationFileName string
เส้นทางของคลังข้อมูลที่จะสร้าง หากชื่อไฟล์ที่ระบุชี้ไปยังไฟล์ที่มีอยู่แล้ว จะถูกเขียนทับ
saveOptions UueSaveOptions
ตัวเลือกสำหรับการบันทึกคลังข้อมูล
ตัวอย่าง
เขียนข้อมูลที่ถูกเข้ารหัสไปยังไฟล์
using (var archive = new UueArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("data.uue");
}ข้อยกเว้น
destinationFileName เป็น null
ผู้เรียกไม่มีสิทธิ์ที่จำเป็นในการเข้าถึง
destinationFileName ว่างเปล่า มีเพียงช่องว่าง หรือมีอักขระที่ไม่ถูกต้อง
การเข้าถึงไฟล์ destinationFileName ถูกปฏิเสธ
destinationFileName ที่ระบุ ชื่อไฟล์ หรือทั้งสองเกินความยาวสูงสุดที่กำหนดโดยระบบ สำหรับตัวอย่าง บนแพลตฟอร์มที่ใช้ Windows เส้นทางต้องมีความยาวน้อยกว่า 248 อักขระ และชื่อไฟล์ต้องมีความยาวน้อยกว่า 260 อักขระ
ไฟล์ที่ destinationFileName มีเครื่องหมายทวิภาค (:) อยู่กลางสตริง
SetSource(Stream)
ตั้งค่าเนื้อหาที่จะถูกเข้ารหัสภายในคลังข้อมูล
public void SetSource(Stream source)พารามิเตอร์
source Stream
สตรีมข้อมูลนำเข้าสำหรับคลังข้อมูล
ตัวอย่าง
using (var archive = new UueArchive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
archive.Save("archive.uue");
}SetSource(FileInfo)
ตั้งค่าเนื้อหาที่จะถูกบีบอัดภายในคลังข้อมูล
public void SetSource(FileInfo fileInfo)พารามิเตอร์
fileInfo FileInfo
การอ้างอิงไปยังไฟล์ที่จะถูกบีบอัด
ตัวอย่าง
using (var archive = new UueArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("archive.uue");
}SetSource(string)
ตั้งค่าเนื้อหาที่จะถูกเข้ารหัสภายในคลังข้อมูล
public void SetSource(string path)พารามิเตอร์
path string
เส้นทางไปยังไฟล์ที่จะถูกเข้ารหัส
ตัวอย่าง
using (var archive = new UueArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.uue");
}ข้อยกเว้น
path เป็น null
ผู้เรียกไม่มีสิทธิ์ที่จำเป็นในการเข้าถึง
path ว่างเปล่า มีเพียงช่องว่าง หรือมีอักขระที่ไม่ถูกต้อง
การเข้าถึงไฟล์ path ถูกปฏิเสธ
path ที่ระบุ ชื่อไฟล์ หรือทั้งสองเกินความยาวสูงสุดที่กำหนดโดยระบบ สำหรับตัวอย่าง บนแพลตฟอร์มที่ใช้ Windows เส้นทางต้องมีความยาวน้อยกว่า 248 อักขระ และชื่อไฟล์ต้องมีความยาวน้อยกว่า 260 อักขระ
ไฟล์ที่ path มีเครื่องหมายทวิภาค (:) อยู่กลางสตริง
