Complex.Magnitude Propriété

Définition

Obtient l'ordre de grandeur (ou valeur absolue) d'un nombre complexe.Gets the magnitude (or absolute value) of a complex number.

public:
 property double Magnitude { double get(); };
public double Magnitude { get; }
member this.Magnitude : double
Public ReadOnly Property Magnitude As Double

Valeur de propriété

Grandeur de l'instance actuelle.The magnitude of the current instance.

Exemples

L’exemple suivant calcule la valeur absolue d’un nombre complexe et démontre qu’il est équivalent à la valeur de la propriété Magnitude.The following example calculates the absolute value of a complex number and demonstrates that it is equivalent to the value of the Magnitude property.

using System;
using System.Numerics;

public class Example
{
   public static void Main()
   {
      Complex complex1 = new Complex(2.0, 3.0);
      Console.WriteLine("|{0}| = {1:N2}", complex1, Complex.Abs(complex1));
      Console.WriteLine("Equal to Magnitude: {0}", 
                        Complex.Abs(complex1).Equals(complex1.Magnitude)); 
   }
}
// The example displays the following output:
//       |(2, 3)| = 3.60555127546399
//       Equal to Magnitude: True
Imports System.Numerics

Module Example
   Public Sub Main()
      Dim complex1 As New Complex(2.0, 3.0)
      Console.WriteLine("|{0}| = {1:N2}", complex1, Complex.Abs(complex1))
      Console.WriteLine("Equal to Magnitude: {0}", 
                        Complex.Abs(complex1).Equals(complex1.Magnitude)) 
   End Sub
End Module
' The example displays the following output:
'       |(2, 3)| = 3.61
'       Equal to Magnitude: True

Remarques

La propriété Magnitude est équivalente à la valeur absolue d’un nombre complexe.The Magnitude property is equivalent to the absolute value of a complex number. Elle spécifie la distance entre l’origine (l’intersection de l’axe des x et de l’axe des y dans le système de coordonnées cartésien) et le point à deux dimensions représenté par un nombre complexe.It specifies the distance from the origin (the intersection of the x-axis and the y-axis in the Cartesian coordinate system) to the two-dimensional point represented by a complex number. La valeur absolue est calculée comme suit :The absolute value is calculated as follows:

|a + bi | = Math.Sqrt(a * a + b * b)| a + bi | = Math.Sqrt(a * a + b * b)

Si le calcul de la valeur absolue provoque un dépassement de capacité, cette propriété retourne soit Double.PositiveInfinity, soit Double.NegativeInfinity.If the calculation of the absolute value results in an overflow, this property returns either Double.PositiveInfinity or Double.NegativeInfinity.

Les propriétés Magnitude et Phase définissent la position d’un point qui représente un nombre complexe dans le système de coordonnées polaires.The Magnitude and the Phase properties define the position of a point that represents a complex number in the polar coordinate system.

Vous pouvez instancier un nombre complexe en fonction de ses coordonnées polaires au lieu de ses coordonnées cartésiennes en appelant la méthode FromPolarCoordinates.You can instantiate a complex number based on its polar coordinates instead of its Cartesian coordinates by calling the FromPolarCoordinates method.

S’applique à

Voir aussi