Image.FromFile Methode

Definition

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

Paket:

System.Drawing.Common v8.0.0

Erstellt ein Image aus der angegebenen Datei.

Überlädt

FromFile(String)	Erstellt ein Image aus der angegebenen Datei.
FromFile(String, Boolean)	Erstellt ein Image aus der angegebenen Datei unter Verwendung der in der Datei eingebetteten Farbverwaltungsinformationen.

FromFile(String)

Quelle:

Image.cs

Erstellt ein Image aus der angegebenen Datei.

public:
 static System::Drawing::Image ^ FromFile(System::String ^ filename);

public static System.Drawing.Image FromFile (string filename);

static member FromFile : string -> System.Drawing.Image

Public Shared Function FromFile (filename As String) As Image

Parameter

filename

String

Eine Zeichenfolge, die den Namen der Datei enthält, aus der Image erstellt werden soll.

Gibt zurück

Image

Die Image, die von dieser Methode erstellt wird.

Ausnahmen

OutOfMemoryException

Die Datei besitzt kein gültiges Bildformat.

- oder -

GDI+ unterstützt das Pixelformat der Datei nicht.

FileNotFoundException

Die angegebene Datei ist nicht vorhanden.

ArgumentException

filename ist ein Uri.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die FromFileGetPropertyItem Methoden und SetPropertyItem verwendet werden. Dieses Beispiel ist für die Verwendung mit Windows Forms konzipiert. Um dieses Beispiel auszuführen, fügen Sie es in ein Formular ein, und behandeln Sie das Ereignis des FormularsPaint, indem Sie die DemonstratePropertyItem -Methode aufrufen und als PaintEventArgsübergebene.

private:
   void DemonstratePropertyItem( PaintEventArgs^ e )
   {
      // Create two images.
      Image^ image1 = Image::FromFile( "c:\\FakePhoto1.jpg" );
      Image^ image2 = Image::FromFile( "c:\\FakePhoto2.jpg" );

      // Get a PropertyItem from image1.
      PropertyItem^ propItem = image1->GetPropertyItem( 20624 );

      // Change the ID of the PropertyItem.
      propItem->Id = 20625;

      // Set the PropertyItem for image2.
      image2->SetPropertyItem( propItem );

      // Draw the image.
      e->Graphics->DrawImage( image2, 20.0F, 20.0F );
   }

private void DemonstratePropertyItem(PaintEventArgs e)
{

    // Create two images.
    Image image1 = Image.FromFile("c:\\FakePhoto1.jpg");
    Image image2 = Image.FromFile("c:\\FakePhoto2.jpg");

    // Get a PropertyItem from image1.
    PropertyItem propItem = image1.GetPropertyItem(20624);

    // Change the ID of the PropertyItem.
    propItem.Id = 20625;

    // Set the PropertyItem for image2.
    image2.SetPropertyItem(propItem);

    // Draw the image.
    e.Graphics.DrawImage(image2, 20.0F, 20.0F);
}

Private Sub DemonstratePropertyItem(ByVal e As PaintEventArgs)

    ' Create two images.
    Dim image1 As Image = Image.FromFile("c:\FakePhoto1.jpg")
    Dim image2 As Image = Image.FromFile("c:\FakePhoto2.jpg")

    ' Get a PropertyItem from image1.
    Dim propItem As PropertyItem = image1.GetPropertyItem(20624)

    ' Change the ID of the PropertyItem.
    propItem.Id = 20625

    ' Set the PropertyItem for image2.
    image2.SetPropertyItem(propItem)

    ' Draw the image.
    e.Graphics.DrawImage(image2, 20.0F, 20.0F)
End Sub

Hinweise

Managed GDI+ verfügt über integrierte Encoder und Decoder, die die folgenden Dateitypen unterstützen:

• BMP

• GIF

• JPEG

• PNG

• TIFF

Die Datei bleibt gesperrt, bis das Image gelöscht wird.

Wenn die Datei kein gültiges Bildformat aufweist oder GDI+ das Pixelformat der Datei nicht unterstützt, löst diese Methode eine Ausnahme aus OutOfMemoryException .

Hinweis

Die Image -Klasse unterstützt keine Alphatransparenz in Bitmaps. Um Alphatransparenz zu ermöglichen, verwenden Sie PNG-Bilder mit 32 Bits pro Pixel.

Weitere Informationen

• Bitmaptypen

FromFile(String, Boolean)

Quelle:

Image.cs

Erstellt ein Image aus der angegebenen Datei unter Verwendung der in der Datei eingebetteten Farbverwaltungsinformationen.

public:
 static System::Drawing::Image ^ FromFile(System::String ^ filename, bool useEmbeddedColorManagement);

public static System.Drawing.Image FromFile (string filename, bool useEmbeddedColorManagement);

static member FromFile : string * bool -> System.Drawing.Image

Public Shared Function FromFile (filename As String, useEmbeddedColorManagement As Boolean) As Image

Parameter

filename

String

Eine Zeichenfolge, die den Namen der Datei enthält, aus der Image erstellt werden soll.

useEmbeddedColorManagement

Boolean

Legen Sie true fest, um die in der Bilddatei enthaltenen Farbverwaltungsinformationen zu verwenden, andernfalls false.

Gibt zurück

Image

Die Image, die von dieser Methode erstellt wird.

Ausnahmen

OutOfMemoryException

Die Datei besitzt kein gültiges Bildformat.

- oder -

GDI+ unterstützt das Pixelformat der Datei nicht.

FileNotFoundException

Die angegebene Datei ist nicht vorhanden.

ArgumentException

filename ist ein Uri.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie mithilfe der FromFile -Methode eine neue Bitmap abrufen. Außerdem wird ein TextureBrushveranschaulicht.

Dieses Beispiel ist für die Verwendung mit Windows Forms konzipiert. Create ein Formular mit einer Schaltfläche mit dem Namen Button2. Fügen Sie den Code in das Formular ein, und ordnen Sie die Button2_Click Methode dem Ereignis der Schaltfläche Click zu.

private:
   void Button2_Click( System::Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      try
      {
         Bitmap^ image1 = dynamic_cast<Bitmap^>(Image::FromFile( "C:\\Documents and Settings\\"
         "All Users\\Documents\\My Music\\music.bmp", true ));
         TextureBrush^ texture = gcnew TextureBrush( image1 );
         texture->WrapMode = System::Drawing::Drawing2D::WrapMode::Tile;
         Graphics^ formGraphics = this->CreateGraphics();
         formGraphics->FillEllipse( texture, RectangleF(90.0F,110.0F,100,100) );
         delete formGraphics;
      }
      catch ( System::IO::FileNotFoundException^ ) 
      {
         MessageBox::Show( "There was an error opening the bitmap."
         "Please check the path." );
      }
   }

private void Button2_Click(System.Object sender, System.EventArgs e)
{
    try
    {
        Bitmap image1 = (Bitmap) Image.FromFile(@"C:\Documents and Settings\" +
            @"All Users\Documents\My Music\music.bmp", true);

        TextureBrush texture = new TextureBrush(image1);
        texture.WrapMode = System.Drawing.Drawing2D.WrapMode.Tile;
        Graphics formGraphics = this.CreateGraphics();
        formGraphics.FillEllipse(texture, 
            new RectangleF(90.0F, 110.0F, 100, 100));
        formGraphics.Dispose();
    }
    catch(System.IO.FileNotFoundException)
    {
        MessageBox.Show("There was an error opening the bitmap." +
            "Please check the path.");
    }
}

Private Sub Button2_Click(ByVal sender As System.Object, _
    ByVal e As System.EventArgs) Handles Button2.Click
    Try
        Dim image1 As Bitmap = _
            CType(Image.FromFile("C:\Documents and Settings\" _
            & "All Users\Documents\My Music\music.bmp", True), Bitmap)

        Dim texture As New TextureBrush(image1)
        texture.WrapMode = Drawing2D.WrapMode.Tile
        Dim formGraphics As Graphics = Me.CreateGraphics()
        formGraphics.FillEllipse(texture, _
            New RectangleF(90.0F, 110.0F, 100, 100))
        formGraphics.Dispose()

    Catch ex As System.IO.FileNotFoundException
        MessageBox.Show("There was an error opening the bitmap." _
            & "Please check the path.")
    End Try

End Sub

Hinweise

Managed GDI+ verfügt über integrierte Encoder und Decoder, die die folgenden Dateitypen unterstützen:

• BMP

• GIF

• JPEG

• PNG

• TIFF

Wenn die Datei kein gültiges Bildformat aufweist oder GDI+ das Pixelformat der Datei nicht unterstützt, löst diese Methode eine Ausnahme aus OutOfMemoryException .

Die Datei bleibt gesperrt, bis das Image gelöscht wird.

Der useEmbeddedColorManagement Parameter gibt an, ob die neue Image Farbkorrektur gemäß den In der Bilddatei eingebetteten Farbverwaltungsinformationen anwendet. Eingebettete Informationen können ICC-Profile (International Color Consortium), Gammawerte und Chromatikinformationen enthalten.

Hinweis

Die Image -Klasse unterstützt keine Alphatransparenz in Bitmaps. Um Alphatransparenz zu ermöglichen, verwenden Sie PNG-Bilder mit 32 Bits pro Pixel.

Weitere Informationen

• Bitmaptypen