Image.FromFile Metodo

Definizione

Spazio dei nomi:

System.Drawing

Assembly:

System.Drawing.Common.dll

Pacchetto:

System.Drawing.Common v8.0.0

Crea un oggetto Image dal file specificato.

Overload

FromFile(String)	Crea un oggetto Image dal file specificato.
FromFile(String, Boolean)	Crea un oggetto Image dal file specificato, usando le informazioni relative alla gestione colori incorporate nel file.

FromFile(String)

Origine:

Image.cs

Crea un oggetto Image dal file specificato.

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

Parametri

filename

String

Stringa contenente il nome del file da cui creare l'oggetto Image.

Restituisce

Image

Oggetto Image creato da questo metodo.

Eccezioni

OutOfMemoryException

Il formato immagine del file non è valido.

-oppure-

GDI+ non supporta il formato pixel del file.

FileNotFoundException

Il file specificato non esiste.

ArgumentException

filename è un oggetto Uri.

Esempio

Nell'esempio di codice seguente viene illustrato come usare i FromFileGetPropertyItem metodi e SetPropertyItem . Questo esempio è progettato per essere usato con Windows Forms. Per eseguire questo esempio, incollarlo in un modulo e gestire l'evento del Paint modulo chiamando il DemonstratePropertyItem metodo, passando e come PaintEventArgs.

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

Commenti

Managed GDI+ include codificatori e decodificatori predefiniti che supportano i tipi di file seguenti:

• BMP

• GIF

• JPEG

• PNG

• TIFF

Il file rimane bloccato finché non Image viene eliminato.

Se il file non ha un formato di immagine valido o se GDI+ non supporta il formato pixel del file, questo metodo genera un'eccezione OutOfMemoryException .

Nota

La Image classe non supporta la trasparenza alfa nelle bitmap. Per abilitare la trasparenza alfa, usare immagini PNG con 32 bit per pixel.

Vedi anche

• Tipi di bitmap

FromFile(String, Boolean)

Origine:

Image.cs

Crea un oggetto Image dal file specificato, usando le informazioni relative alla gestione colori incorporate nel file.

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

Parametri

filename

String

Stringa contenente il nome del file da cui creare l'oggetto Image.

useEmbeddedColorManagement

Boolean

Impostare su true per usare le informazioni sulla gestione colori incorporate nel file di immagine; in caso contrario, impostare su false.

Restituisce

Image

Oggetto Image creato da questo metodo.

Eccezioni

OutOfMemoryException

Il formato immagine del file non è valido.

-oppure-

GDI+ non supporta il formato pixel del file.

FileNotFoundException

Il file specificato non esiste.

ArgumentException

filename è un oggetto Uri.

Esempio

Nell'esempio di codice seguente viene illustrato come ottenere una nuova bitmap usando il FromFile metodo . Illustra anche un TextureBrushoggetto .

Questo esempio è progettato per essere usato con Windows Forms. Create un modulo contenente un pulsante denominato Button2. Incollare il codice nel modulo e associare il Button2_Click metodo all'evento del Click pulsante.

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

Commenti

Managed GDI+ include codificatori e decodificatori predefiniti che supportano i tipi di file seguenti:

• BMP

• GIF

• JPEG

• PNG

• TIFF

Se il file non ha un formato di immagine valido o se GDI+ non supporta il formato pixel del file, questo metodo genera un'eccezione OutOfMemoryException .

Il file rimane bloccato finché non Image viene eliminato.

Il useEmbeddedColorManagement parametro specifica se la nuova Image correzione del colore viene applicata in base alle informazioni di gestione dei colori incorporate nel file di immagine. Le informazioni incorporate possono includere profili International Color Consortium (ICC), valori gamma e informazioni sulla cromaticità.

Nota

La Image classe non supporta la trasparenza alfa nelle bitmap. Per abilitare la trasparenza alfa, usare immagini PNG con 32 bit per pixel.

Vedi anche

• Tipi di bitmap