FormatException Kelas

Definisi

Ruang nama:

System

Rakitan:

System.Runtime.dll

Sumber:

FormatException.cs

Pengecualian yang dilemparkan ketika format argumen tidak valid, atau ketika string format komposit tidak terbentuk dengan baik.

public ref class FormatException : SystemException

public class FormatException : SystemException

type FormatException = class
    inherit SystemException

Public Class FormatException
Inherits SystemException

Warisan

Object

Exception

SystemException

FormatException

Turunan

System.IO.FileFormatException

System.Net.CookieException

System.Reflection.CustomAttributeFormatException

System.UriFormatException

Keterangan

FormatException Pengecualian dapat dilemparkan karena salah satu alasan berikut:

• Dalam panggilan ke metode yang mengonversi string ke beberapa jenis data lainnya, string tidak sesuai dengan pola yang diperlukan. Ini biasanya terjadi ketika memanggil beberapa metode Convert kelas dan Parse metode dan ParseExact dari beberapa jenis.

  Dalam kebanyakan kasus, terutama jika string yang Anda konversi adalah input oleh pengguna atau dibaca dari file, Anda harus menggunakan try/catch blok (try/with di F#) dan menangani FormatException pengecualian jika konversi tidak berhasil. Anda juga dapat mengganti panggilan ke metode konversi dengan panggilan ke TryParse metode atau TryParseExact , jika ada. Namun, FormatException pengecualian yang dilemparkan saat Anda mencoba mengurai string yang telah ditentukan atau dikodekan secara permanen menunjukkan kesalahan program. Dalam hal ini, Anda harus memperbaiki kesalahan daripada menangani pengecualian.

  Konversi string ke jenis berikut di System namespace layanan dapat memberikan FormatException pengecualian:

  • Boolean. Metode Boolean.Parse(String) dan Convert.ToBoolean(String) mengharuskan string dikonversi menjadi "True", "true", "False", atau "false". Nilai lain memberikan FormatException pengecualian.

  • DateTime dan DateTimeOffset. Semua data tanggal dan waktu ditafsirkan berdasarkan konvensi pemformatan budaya tertentu: baik budaya saat ini (atau, dalam beberapa kasus, budaya domain aplikasi saat ini), budaya invarian, atau budaya tertentu. Saat Anda memanggil DateTime.ParseExact(String, String, IFormatProvider, DateTimeStyles) metode dan DateTimeOffset.ParseExact(String, String[], IFormatProvider, DateTimeStyles) , data tanggal dan waktu juga harus sesuai persis dengan pola yang ditentukan oleh satu atau beberapa string format standar atau string format kustom yang disediakan sebagai argumen dalam panggilan metode. Jika tidak sesuai dengan pola khusus budaya yang diharapkan, FormatException pengecualian akan dilemparkan. Ini berarti bahwa data tanggal dan waktu yang disimpan dalam format khusus budaya pada satu sistem mungkin tidak berhasil diurai pada sistem lain.

    Untuk informasi selengkapnya tentang penguraian tanggal dan waktu, lihat Mengurai String Tanggal dan Waktu dan dokumentasi untuk metode yang melemparkan pengecualian.

  • GUID. Representasi string GUID harus terdiri dari 32 digit heksadesimal (0-F), dan harus dalam salah satu dari lima format output dengan Guid.ToString metode . Untuk informasi lebih lanjut, lihat Guid.Parsemetodenya.

  • Jenis numerik, termasuk semua bilangan bulat yang ditandatangani, bilangan bulat yang tidak ditandatangani, dan jenis floating-point. String yang akan diurai harus terdiri dari digit Latin 0-9. Tanda positif atau negatif, pemisah desimal, pemisah grup, dan simbol mata uang juga dapat diizinkan. Mencoba mengurai string yang berisi karakter lain selalu melempar FormatException pengecualian.

    Semua string numerik ditafsirkan berdasarkan konvensi pemformatan budaya tertentu: baik budaya saat ini, budaya invarian, atau budaya tertentu. Akibatnya, string numerik yang diurai dengan menggunakan konvensi satu budaya mungkin gagal saat menggunakan konvensi yang lain.

    Untuk informasi selengkapnya tentang penguraian string numerik, lihat Mengurai String Numerik dan dokumentasi untuk metode tertentu yang melemparkan pengecualian.

  • Interval waktu. String yang akan diurai harus dalam format budaya tetap yang tidak sensitif atau dalam format sensitif budaya yang ditentukan oleh budaya saat ini, budaya invarian, atau budaya tertentu. Jika string tidak dalam format yang sesuai, atau jika, pada komponen minimum, hari, jam, dan menit dari interval waktu tidak ada, metode penguraian akan memberikan FormatException pengecualian. Untuk informasi selengkapnya, lihat dokumentasi untuk TimeSpan metode penguraian yang melemparkan pengecualian.

• Jenis mengimplementasikan IFormattable antarmuka, yang mendukung string format yang menentukan bagaimana objek dikonversi ke representasi stringnya, dan string format yang tidak valid digunakan. Ini paling umum dalam operasi pemformatan. Dalam contoh berikut, string format standar "Q" digunakan dalam string format komposit untuk memformat angka. Namun, "Q" bukan string format standar yang valid.

  using System;
  
  public class Example
  {
     public static void Main()
     {
        decimal price = 169.32m;
        Console.WriteLine("The cost is {0:Q2}.", price);
     }
  }
  // The example displays the following output:
  //    Unhandled Exception: System.FormatException: Format specifier was invalid.
  //       at System.Number.FormatDecimal(Decimal value, String format, NumberFormatInfo info)
  //       at System.Decimal.ToString(String format, IFormatProvider provider)
  //       at System.Text.StringBuilder.AppendFormat(IFormatProvider provider, String format, Object[] args)
  //       at System.IO.TextWriter.WriteLine(String format, Object arg0)
  //       at System.IO.TextWriter.SyncTextWriter.WriteLine(String format, Object arg0)
  //       at Example.Main()
  

  let price = 169.32m
  printfn $"The cost is {price:Q2}."
  // The example displays the following output:
  //    Unhandled Exception: System.FormatException: Format specifier was invalid.
  //       at System.Number.NumberToString(ValueStringBuilder& sb, NumberBuffer& number, Char format, Int32 nMaxDigits, NumberFormatInfo info)
  //       at System.Number.TryFormatDecimal(Decimal value, ReadOnlySpan`1 format, NumberFormatInfo info, Span`1 destination, Int32& charsWritten)
  //       at System.Decimal.TryFormat(Span`1 destination, Int32& charsWritten, ReadOnlySpan`1 format, IFormatProvider provider)
  //       at System.Text.ValueStringBuilder.AppendFormatHelper(IFormatProvider provider, String format, ParamsArray args)
  //       at System.String.FormatHelper(IFormatProvider provider, String format, ParamsArray args)
  //       at Microsoft.FSharp.Core.PrintfImpl.InterpolandToString@917.Invoke(Object vobj)
  //       at Microsoft.FSharp.Core.PrintfImpl.PrintfEnv`3.RunSteps(Object[] args, Type[] argTys, Step[] steps)
  //       at Microsoft.FSharp.Core.PrintfModule.gprintf[a,TState,TResidue,TResult,TPrinter](FSharpFunc`2 envf, PrintfFormat`4 format)
  //       at <StartupCode$fs>.$Example.main@()
  

  Module Example
     Public Sub Main()
        Dim price As Decimal = 169.32d
        Console.WriteLine("The cost is {0:Q2}.", price)
     End Sub
  End Module
  ' The example displays the following output:
  '    Unhandled Exception: System.FormatException: Format specifier was invalid.
  '       at System.Number.FormatDecimal(Decimal value, String format, NumberFormatInfo info)
  '       at System.Decimal.ToString(String format, IFormatProvider provider)
  '       at System.Text.StringBuilder.AppendFormat(IFormatProvider provider, String format, Object[] args)
  '       at System.IO.TextWriter.WriteLine(String format, Object arg0)
  '       at System.IO.TextWriter.SyncTextWriter.WriteLine(String format, Object arg0)
  '       at Example.Main()
  

  Pengecualian ini dihasilkan dari kesalahan pengkodian. Untuk memperbaiki kesalahan, hapus string format atau ganti string yang valid. Contoh berikut memperbaiki kesalahan dengan mengganti string format yang tidak valid dengan string format "C" (mata uang).

  using System;
  
  public class Example
  {
     public static void Main()
     {
        decimal price = 169.32m;
        Console.WriteLine("The cost is {0:C2}.", price);
     }
  }
  // The example displays the following output:
  //    The cost is $169.32.
  

  let price = 169.32m
  printfn $"The cost is {price:C2}."
  // The example displays the following output:
  //    The cost is $169.32.
  

  Module Example
     Public Sub Main()
        Dim price As Decimal = 169.32d
        Console.WriteLine("The cost is {0:C2}.", price)
     End Sub
  End Module
  ' The example displays the following output:
  '   The cost is $169.32.
  

  FormatException Pengecualian juga dapat dilemparkan dengan metode penguraian, seperti DateTime.ParseExact dan Guid.ParseExact, yang mengharuskan string diurai agar sesuai persis dengan pola yang ditentukan oleh string format. Dalam contoh berikut, representasi string GUID diharapkan sesuai dengan pola yang ditentukan oleh string format standar "G". Namun, Guid implementasi IFormattable struktur tidak mendukung string format "G".

  using System;
  
  public class Example
  {
     public static void Main()
     {
        string guidString = "ba748d5c-ae5f-4cca-84e5-1ac5291c38cb";
        Console.WriteLine(Guid.ParseExact(guidString, "G"));
     }
  }
  // The example displays the following output:
  //    Unhandled Exception: System.FormatException:
  //       Format String can be only "D", "d", "N", "n", "P", "p", "B", "b", "X" or "x".
  //       at System.Guid.ParseExact(String input, String format)
  //       at Example.Main()
  

  open System
  
  let guidString = "ba748d5c-ae5f-4cca-84e5-1ac5291c38cb"
  printfn $"""{Guid.ParseExact(guidString, "G")}"""
  // The example displays the following output:
  //    Unhandled Exception: System.FormatException:
  //       Format String can be only "D", "d", "N", "n", "P", "p", "B", "b", "X" or "x".
  //       at System.Guid.ParseExact(String input, String format)
  //       at <StartupCode$fs>.$Example.main@()
  

  Module Example
     Public Sub Main()
        Dim guidString As String = "ba748d5c-ae5f-4cca-84e5-1ac5291c38cb"
        Console.WriteLine(Guid.ParseExact(guidString, "G"))
     End Sub
  End Module
  ' The example displays the following output:
  '    Unhandled Exception: System.FormatException: 
  '       Format String can be only "D", "d", "N", "n", "P", "p", "B", "b", "X" or "x".
  '       at System.Guid.ParseExact(String input, String format)
  '       at Example.Main()
  

  Pengecualian ini juga dihasilkan dari kesalahan pengkodian. Untuk memperbaikinya, panggil metode penguraian yang tidak memerlukan format yang tepat, seperti DateTime.Parse atau Guid.Parse, atau ganti string format yang valid. Contoh berikut memperbaiki kesalahan dengan memanggil Guid.Parse metode .

  using System;
  
  public class Example
  {
     public static void Main()
     {
        string guidString = "ba748d5c-ae5f-4cca-84e5-1ac5291c38cb";
        Console.WriteLine(Guid.Parse(guidString));
     }
  }
  // The example displays the following output:
  //    ba748d5c-ae5f-4cca-84e5-1ac5291c38cb
  

  open System
  
  let guidString = "ba748d5c-ae5f-4cca-84e5-1ac5291c38cb"
  printfn $"{Guid.Parse guidString}"
  // The example displays the following output:
  //    ba748d5c-ae5f-4cca-84e5-1ac5291c38cb
  

  Module Example
     Public Sub Main()
        Dim guidString As String = "ba748d5c-ae5f-4cca-84e5-1ac5291c38cb"
        Console.WriteLine(Guid.Parse(guidString))
     End Sub
  End Module
  ' The example displays the following output:
  '   ba748d5c-ae5f-4cca-84e5-1ac5291c38cb
  

• Satu atau beberapa indeks item format dalam string format komposit lebih besar dari indeks item dalam daftar objek atau array parameter. Dalam contoh berikut, indeks terbesar item format dalam string format adalah 3. Karena indeks item dalam daftar objek berbasis nol, string format ini akan mengharuskan daftar objek memiliki empat item. Sebaliknya, hanya memiliki tiga, dat, , tempdan scale, sehingga kode menghasilkan FormatException pengecualian pada durasi:.

  using System;
  
  public class Example
  {
     public enum TemperatureScale
     { Celsius, Fahrenheit, Kelvin }
  
     public static void Main()
     {
        String info = GetCurrentTemperature();
        Console.WriteLine(info);
     }
  
     private static String GetCurrentTemperature()
     {
        DateTime dat = DateTime.Now;
        Decimal temp = 20.6m;
        TemperatureScale scale = TemperatureScale.Celsius;
        String result;
  
        result = String.Format("At {0:t} on {1:D}, the temperature is {2:F1} {3:G}",
                               dat, temp, scale);
        return result;
     }
  }
  // The example displays output like the following:
  //    Unhandled Exception: System.FormatException: Format specifier was invalid.
  //       at System.Number.FormatDecimal(Decimal value, String format, NumberFormatInfo info)
  //       at System.Decimal.ToString(String format, IFormatProvider provider)
  //       at System.Text.StringBuilder.AppendFormat(IFormatProvider provider, String format, Object[] args)
  //       at System.String.Format(IFormatProvider provider, String format, Object[] args)
  //       at Example.Main()
  

  open System
  
  type TemperatureScale =
      | Celsius = 0
      | Fahrenheit = 1
      | Kelvin = 2
  
  let getCurrentTemperature () =
      let dat = DateTime.Now
      let temp = 20.6m
      let scale = TemperatureScale.Celsius
      String.Format("At {0:t} on {1:D}, the temperature is {2:F1} {3:G}", dat, temp, scale)
  
  getCurrentTemperature ()
  |> printfn "%s"
  
  // The example displays output like the following:
  //    Unhandled Exception: System.FormatException: Format specifier was invalid.
  //       at System.Number.NumberToString(ValueStringBuilder& sb, NumberBuffer& number, Char format, Int32 nMaxDigits, NumberFormatInfo info)   
  //       at System.Number.TryFormatDecimal(Decimal value, ReadOnlySpan`1 format, NumberFormatInfo info, Span`1 destination, Int32& charsWritten)
  //       at System.Decimal.TryFormat(Span`1 destination, Int32& charsWritten, ReadOnlySpan`1 format, IFormatProvider provider)       
  //       at System.Text.ValueStringBuilder.AppendFormatHelper(IFormatProvider provider, String format, ParamsArray args)
  //       at System.String.FormatHelper(IFormatProvider provider, String format, ParamsArray args)
  //       at System.String.Format(String format, Object arg0, Object arg1, Object arg2)
  //       at Example.getCurrentTemperature()
  //       at <StartupCode$fs>.$Example.main@()
  

  Module Example
     Public Enum TemperatureScale As Integer
        Celsius
        Fahrenheit
        Kelvin
     End Enum
  
     Public Sub Main()
        Dim info As String = GetCurrentTemperature()
        Console.WriteLine(info)
     End Sub
  
     Private Function GetCurrentTemperature() As String
        Dim dat As Date = Date.Now
        Dim temp As Decimal = 20.6d
        Dim scale As TemperatureScale = TemperatureScale.Celsius
        Dim result As String 
        
        result = String.Format("At {0:t} on {1:D}, the temperature is {2:F1} {3:G}",
                               dat, temp, scale)    
        Return result
     End Function
  End Module
  ' The example displays output like the following:
  '    Unhandled Exception: System.FormatException: Format specifier was invalid.
  '       at System.Number.FormatDecimal(Decimal value, String format, NumberFormatInfo info)
  '       at System.Decimal.ToString(String format, IFormatProvider provider)
  '       at System.Text.StringBuilder.AppendFormat(IFormatProvider provider, String format, Object[] args)
  '       at System.String.Format(IFormatProvider provider, String format, Object[] args)
  '       at Example.Main()
  

  Dalam hal ini, FormatException pengecualian adalah akibat dari kesalahan pengembang. Ini harus dikoreksi daripada ditangani dalam try/catch blok dengan memastikan bahwa setiap item dalam daftar objek sesuai dengan indeks item format. Untuk memperbaiki contoh ini, ubah indeks item format kedua untuk merujuk ke dat variabel, dan mengurangi indeks setiap item format berikutnya satu per satu.

  using System;
  
  public class Example
  {
     public enum TemperatureScale
     { Celsius, Fahrenheit, Kelvin }
  
     public static void Main()
     {
        String info = GetCurrentTemperature();
        Console.WriteLine(info);
     }
  
     private static String GetCurrentTemperature()
     {
        DateTime dat = DateTime.Now;
        Decimal temp = 20.6m;
        TemperatureScale scale = TemperatureScale.Celsius;
        String result;
  
        result = String.Format("At {0:t} on {0:D}, the temperature is {1:F1} {2:G}",
                               dat, temp, scale);
        return result;
     }
  }
  // The example displays output like the following:
  //    At 10:40 AM on Wednesday, June 04, 2014, the temperature is 20.6 Celsius
  

  open System
  
  type TemperatureScale =
      | Celsius = 0
      | Fahrenheit = 1
      | Kelvin = 2
  
  let getCurrentTemperature () =
      let dat = DateTime.Now
      let temp = 20.6m
      let scale = TemperatureScale.Celsius
      String.Format("At {0:t} on {0:D}, the temperature is {1:F1} {2:G}", dat, temp, scale)
  
  getCurrentTemperature ()
  |> printfn "%s"
  
  // The example displays output like the following:
  //    At 10:40 AM on Wednesday, June 04, 2014, the temperature is 20.6 Celsius
  

  Module Example
     Public Enum TemperatureScale As Integer
        Celsius
        Fahrenheit
        Kelvin
     End Enum
  
     Public Sub Main()
        Dim info As String = GetCurrentTemperature()
        Console.WriteLine(info)
     End Sub
  
     Private Function GetCurrentTemperature() As String
        Dim dat As Date = Date.Now
        Dim temp As Decimal = 20.6d
        Dim scale As TemperatureScale = TemperatureScale.Celsius
        Dim result As String 
        
        result = String.Format("At {0:t} on {0:D}, the temperature is {1:F1} {2:G}",
                               dat, temp, scale)    
        Return result
     End Function
  End Module
  ' The example displays output like the following:
  '       At 10:40 AM on Wednesday, June 04, 2014, the temperature is 20.6 Celsius
  

• String format komposit tidak terbentuk dengan baik. Ketika ini terjadi, FormatException pengecualian selalu merupakan akibat dari kesalahan pengembang. Ini harus dikoreksi daripada ditangani dalam try/catch blok.

  Mencoba menyertakan kurung kurawal harfiah dalam string, seperti contoh berikut, akan melemparkan pengecualian.

  result = String.Format("The text has {0} '{' characters and {1} '}' characters.",
                         nOpen, nClose);
  

  let result = 
      String.Format("The text has {0} '{' characters and {1} '}' characters.", nOpen, nClose)
  

  result = String.Format("The text has {0} '{' characters and {1} '}' characters.",
                         nOpen, nClose)
  

  Teknik yang direkomendasikan untuk menyertakan kurung kurawal harfiah dalam string format komposit adalah menyertakannya dalam daftar objek dan menggunakan item format untuk memasukkannya ke dalam string hasil. Misalnya, Anda dapat memodifikasi string format komposit sebelumnya seperti yang ditunjukkan di sini.

  string result;
  int nOpen = 1;
  int nClose = 2;
  result = String.Format("The text has {0} '{{' characters and {1} '}}' characters.",
                         nOpen, nClose);
  Console.WriteLine(result);
  

  let result =
      String.Format("The text has {0} '{{' characters and {1} '}}' characters.", nOpen, nClose)
  

  result = String.Format("The text has {0} '{{' characters and {1} '}}' characters.",
                         nOpen, nClose)
  

  Pengecualian juga dilemparkan jika string format Anda berisi kesalahan ketik. Panggilan berikut ke String.Format metode menghilangkan kurung kurawal penutup dan memasangkan kurung kurawal pembuka dengan kurung tutup.

  int n1 = 10;
  int n2 = 20;
  String result = String.Format("{0 + {1] = {2}",
                                n1, n2, n1 + n2);
  

  let n1 = 10
  let n2 = 20
  String result = String.Format("{0 + {1] = {2}",
                              n1, n2, n1 + n2)
  

  Dim n1 As Integer = 10
  Dim n2 As Integer = 20
  Dim result As String = String.Format("{0 + {1] = {2}", 
                                       n1, n2, n1 + n2)
  

  Untuk memperbaiki kesalahan, pastikan bahwa semua kurung kurawal buka dan tutup sesuai.

  String result = String.Format("{0} + {1} = {2}",
                                n1, n2, n1 + n2);
  

  let result = String.Format("{0} + {1} = {2}", n1, n2, n1 + n2)
  

  Dim result As String = String.Format("{0} + {1} = {2}", 
                                       n1, n2, n1 + n2)
  

• Anda telah menyediakan daftar objek dalam metode pemformatan komposit sebagai array parameter yang diketik dengan kuat, dan FormatException pengecualian menunjukkan bahwa indeks satu atau beberapa item format melebihi jumlah argumen dalam daftar objek. Ini terjadi karena tidak ada konversi eksplisit antara jenis array, jadi sebaliknya pengkompilasi memperlakukan array sebagai argumen tunggal daripada sebagai array parameter. Misalnya, panggilan berikut ke Console.WriteLine(String, Object[]) metode melempar FormatException pengecualian, meskipun indeks tertinggi dari item format adalah 3, dan array parameter jenis Int32 memiliki empat elemen.

  using System;
  using System.Collections.Generic;
  
  public class Example
  {
     public static void Main()
     {
        Random rnd = new Random();
        int[]  numbers = new int[4];
        int total = 0;
        for (int ctr = 0; ctr <= 2; ctr++) {
           int number = rnd.Next(1001);
           numbers[ctr] = number;
           total += number;
        }
        numbers[3] = total;
        Console.WriteLine("{0} + {1} + {2} = {3}", numbers);
     }
  }
  // The example displays the following output:
  //    Unhandled Exception:
  //    System.FormatException:
  //       Index (zero based) must be greater than or equal to zero and less than the size of the argument list.
  //       at System.Text.StringBuilder.AppendFormat(IFormatProvider provider, String format, Object[] args)
  //       at System.IO.TextWriter.WriteLine(String format, Object arg0)
  //       at System.IO.TextWriter.SyncTextWriter.WriteLine(String format, Object arg0)
  //       at Example.Main()
  

  open System
  
  let rnd = Random()
  let numbers = Array.zeroCreate<int> 4
  let mutable total = 0
  for i = 0 to 2 do
      let number = rnd.Next 1001
      numbers[i] <- number
      total <- total + number
  numbers[3] <- total
  Console.WriteLine("{0} + {1} + {2} = {3}", numbers)
  
  // The example displays the following output:
  //    Unhandled Exception:
  //    System.FormatException:
  //       Index (zero based) must be greater than or equal to zero and less than the size of the argument list.
  //       at System.Text.StringBuilder.AppendFormat(IFormatProvider provider, String format, Object[] args)
  //       at System.IO.TextWriter.WriteLine(String format, Object arg0)
  //       at System.IO.TextWriter.SyncTextWriter.WriteLine(String format, Object arg0)
  //       at <StartupCode$fs>.$Example.main@()
  

  Imports System.Collections.Generic
  
  Module Example
     Public Sub Main()
        Dim rnd As New Random()
        Dim numbers(3) As Integer
        Dim total As Integer = 0
        For ctr = 0 To 2
           Dim number As Integer = rnd.Next(1001)
           numbers(ctr) = number
           total += number
        Next
        numbers(3) = total
        Console.WriteLine("{0} + {1} + {2} = {3}", numbers)   
     End Sub
  End Module
  ' The example displays the following output:
  '    Unhandled Exception: 
  '    System.FormatException: 
  '       Index (zero based) must be greater than or equal to zero and less than the size of the argument list.
  '       at System.Text.StringBuilder.AppendFormat(IFormatProvider provider, String format, Object[] args)
  '       at System.IO.TextWriter.WriteLine(String format, Object arg0)
  '       at System.IO.TextWriter.SyncTextWriter.WriteLine(String format, Object arg0)
  '       at Example.Main()
  

  Alih-alih menangani pengecualian ini, Anda harus menghilangkan penyebabnya. Karena Visual Basic maupun C# tidak dapat mengonversi array bilangan bulat ke array objek, Anda harus melakukan konversi sendiri sebelum memanggil metode pemformatan komposit. Contoh berikut memberikan kemungkinan implementasi.

  using System;
  using System.Collections.Generic;
  
  public class Example
  {
     public static void Main()
     {
        Random rnd = new Random();
        int[]  numbers = new int[4];
        int total = 0;
        for (int ctr = 0; ctr <= 2; ctr++) {
           int number = rnd.Next(1001);
           numbers[ctr] = number;
           total += number;
        }
        numbers[3] = total;
        object[] values = new object[numbers.Length];
        numbers.CopyTo(values, 0);
        Console.WriteLine("{0} + {1} + {2} = {3}", values);
     }
  }
  // The example displays output like the following:
  //        477 + 956 + 901 = 2334
  

  open System
  
  let rnd = Random()
  let numbers = Array.zeroCreate<int> 4
  let mutable total = 0
  for i = 0 to 2 do
      let number = rnd.Next 1001
      numbers[i] <- number
      total <- total + number
  numbers[3] <- total
  let values = Array.zeroCreate<obj> numbers.Length
  numbers.CopyTo(values, 0)
  Console.WriteLine("{0} + {1} + {2} = {3}", values)
  // The example displays output like the following:
  //        477 + 956 + 901 = 2334
  

  Imports System.Collections.Generic
  
  Module Example
     Public Sub Main()
        Dim rnd As New Random()
        Dim numbers(3) As Integer
        Dim total As Integer = 0
        For ctr = 0 To 2
           Dim number As Integer = rnd.Next(1001)
           numbers(ctr) = number
           total += number
        Next
        numbers(3) = total
        Dim values(numbers.Length - 1) As Object
        numbers.CopyTo(values, 0) 
        Console.WriteLine("{0} + {1} + {2} = {3}", values)   
     End Sub
  End Module
  ' The example displays output like the following:
  '       477 + 956 + 901 = 2334
  

FormatException menggunakan COR_E_FORMAT HRESULT, yang memiliki nilai 0x80131537.

Kelas FormatException berasal dari Exception dan tidak menambahkan anggota unik. Untuk daftar nilai properti awal untuk instans FormatException, lihat FormatException konstruktor.

Konstruktor

FormatException()	Menginisialisasi instans baru kelas FormatException.
FormatException(SerializationInfo, StreamingContext)	Kedaluwarsa. Menginisialisasi instans FormatException baru kelas dengan data berseri.
FormatException(String)	Menginisialisasi instans FormatException baru kelas dengan pesan kesalahan yang ditentukan.
FormatException(String, Exception)	Menginisialisasi instans FormatException baru kelas dengan pesan kesalahan yang ditentukan dan referensi ke pengecualian dalam yang merupakan penyebab pengecualian ini.

Properti

Data	Mendapatkan kumpulan pasangan kunci/nilai yang memberikan informasi tambahan yang ditentukan pengguna tentang pengecualian. (Diperoleh dari Exception)
HelpLink	Mendapatkan atau mengatur tautan ke file bantuan yang terkait dengan pengecualian ini. (Diperoleh dari Exception)
HResult	Mendapatkan atau menetapkan HRESULT, nilai numerik berkode yang ditetapkan ke pengecualian tertentu. (Diperoleh dari Exception)
InnerException	Mendapatkan instans Exception yang menyebabkan pengecualian saat ini. (Diperoleh dari Exception)
Message	Mendapatkan pesan yang menjelaskan pengecualian saat ini. (Diperoleh dari Exception)
Source	Get dan set nama aplikasi atau objek yang menyebabkan kesalahan. (Diperoleh dari Exception)
StackTrace	Mendapatkan representasi string dari bingkai langsung pada tumpukan panggilan. (Diperoleh dari Exception)
TargetSite	Mendapatkan metode yang melemparkan pengecualian saat ini. (Diperoleh dari Exception)

Metode

Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetBaseException()	Ketika ditimpa di kelas turunan, mengembalikan Exception yang merupakan akar penyebab dari satu atau beberapa pengecualian berikutnya. (Diperoleh dari Exception)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetObjectData(SerializationInfo, StreamingContext)	Kedaluwarsa. Saat ditimpa di kelas turunan, mengatur SerializationInfo dengan informasi tentang pengecualian. (Diperoleh dari Exception)
GetType()	Mendapatkan jenis runtime instans saat ini. (Diperoleh dari Exception)
MemberwiseClone()	Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
ToString()	Membuat dan mengembalikan representasi string dari pengecualian saat ini. (Diperoleh dari Exception)

Acara

SerializeObjectState

Kedaluwarsa. Terjadi ketika pengecualian diserialisasikan untuk membuat objek status pengecualian yang berisi data berseri tentang pengecualian. (Diperoleh dari Exception)

Lihat juga

• Exception
• Menangani dan Melempar Pengecualian