ExceptionDispatchInfo.SetRemoteStackTrace(Exception, String) Metode

Definisi

Ruang nama:

System.Runtime.ExceptionServices

Rakitan:

netstandard.dll, System.Runtime.dll

Sumber:

ExceptionDispatchInfo.cs

Menyimpan jejak tumpukan yang disediakan ke dalam instans yang ditentukan Exception .

public:
 static Exception ^ SetRemoteStackTrace(Exception ^ source, System::String ^ stackTrace);

public static Exception SetRemoteStackTrace(Exception source, string stackTrace);

static member SetRemoteStackTrace : Exception * string -> Exception

Public Shared Function SetRemoteStackTrace (source As Exception, stackTrace As String) As Exception

Parameter

source

Exception

Pengecualian yang belum ditumbuhi.

stackTrace

String

String pelacakan tumpukan untuk bertahan di dalam source. Ini biasanya diperoleh dari StackTrace properti instans pengecualian jarak jauh.

Mengembalikan

Exception

Instans source pengecualian.

Pengecualian

ArgumentNullException

Argumen source atau stackTrace adalah null.

InvalidOperationException

Argumen source sebelumnya dilemparkan atau sebelumnya memiliki jejak tumpukan yang disimpan ke dalamnya.

Keterangan

Metode ini mengisi StackTrace properti dari nilai string arbitrer. Kasus penggunaan umum adalah transmisi Exception objek di seluruh proses dengan keakuratan tinggi, memungkinkan pelestarian informasi pelacakan tumpukan objek pengecualian. .NET tidak mencoba mengurai nilai string yang disediakan.

Pemanggil bertanggung jawab untuk melakukan kanonisisasi akhiran baris jika diperlukan. ReplaceLineEndings() dapat digunakan untuk melakukan kanonikalisasi akhir baris.

Jika penelepon memberikan input yang tidak tepercaya ke API ini, ini dapat mengakibatkan jejak tumpukan pengecualian yang berisi karakter null yang disematkan, karakter HTML atau JSON yang dicadangkan, atau nilai tak terduga lainnya. Aplikasi yang menampilkan detail pengecualian kepada pengguna harus selalu berhati-hati untuk mengodekan informasi pengecualian pada titik tempatnya ditampilkan.