Code:
/ 4.0 / 4.0 / DEVDIV_TFS / Dev10 / Releases / RTMRel / ndp / fx / src / Net / System / Net / Mail / MailAddress.cs / 1305376 / MailAddress.cs
//------------------------------------------------------------------------------ //// Copyright (c) Microsoft Corporation. All rights reserved. // //----------------------------------------------------------------------------- namespace System.Net.Mail { using System; using System.Text; using System.Net.Mime; using System.Diagnostics; using System.Globalization; // // This class stores the basic components of an e-mail address as described in RFC 2822 Section 3.4. // Any parsing required is done with the MailAddressParser class. // public class MailAddress { // These components form an e-mail address when assembled as follows: // "EncodedDisplayname"private readonly Encoding displayNameEncoding; private readonly string displayName; private readonly string userName; private readonly string host; // For internal use only by MailAddressParser. // The components were already validated before this is called. internal MailAddress(string displayName, string userName, string domain) { this.host = domain; this.userName = userName; this.displayName = displayName; this.displayNameEncoding = Encoding.GetEncoding(MimeBasePart.defaultCharSet); Debug.Assert(host != null, "host was null in internal constructor"); Debug.Assert(userName != null, "userName was null in internal constructor"); Debug.Assert(displayName != null, "displayName was null in internal constructor"); } public MailAddress(string address) : this(address, null, (Encoding)null) { } public MailAddress(string address, string displayName) : this(address, displayName, (Encoding)null) { } // // This constructor validates and stores the components of an e-mail address. // // Preconditions: // - 'address' must not be null or empty. // // Postconditions: // - The e-mail address components from the given 'address' are parsed, which should be formatted as: // "EncodedDisplayname" // - If a 'displayName' is provided separately, it overrides whatever display name is parsed from the 'address' // field. The display name does not need to be pre-encoded if a 'displayNameEncoding' is provided. // // A FormatException will be thrown if any of the components in 'address' are invalid. public MailAddress(string address, string displayName, Encoding displayNameEncoding) { if (address == null){ throw new ArgumentNullException("address"); } if (address == String.Empty){ throw new ArgumentException(SR.GetString(SR.net_emptystringcall,"address"), "address"); } this.displayNameEncoding = displayNameEncoding ?? Encoding.GetEncoding(MimeBasePart.defaultCharSet); this.displayName = displayName ?? string.Empty; // Check for bounding quotes if (!String.IsNullOrEmpty(this.displayName)) { if (this.displayName.Length >= 2 && this.displayName[0] == '\"' && this.displayName[this.displayName.Length - 1] == '\"') { // Peal bounding quotes, they'll get re-added later. this.displayName = this.displayName.Substring(1, this.displayName.Length - 2); } } MailAddress result = MailAddressParser.ParseAddress(address); this.host = result.host; this.userName = result.userName; // If we were not given a display name, use the one parsed from 'address'. if (String.IsNullOrEmpty(this.displayName)) { this.displayName = result.displayName; } } public string DisplayName { get { return displayName; } } public string User { get { return this.userName; } } public string Host { get { return this.host; } } public string Address { get { return String.Format(CultureInfo.InvariantCulture, "{0}@{1}", userName, host); } } internal string SmtpAddress{ get{ return String.Format(CultureInfo.InvariantCulture, "<{0}>", Address); } } /// /// this returns the full address with quoted display name. /// i.e. "some email address display name" ////// if displayname is not provided then this returns only user@host (no angle brackets) /// public override string ToString() { if (String.IsNullOrEmpty(DisplayName)) { return this.Address; } else { return String.Format("\"{0}\" {1}", DisplayName, SmtpAddress); } } public override bool Equals(object value) { if (value == null) { return false; } return ToString().Equals(value.ToString(),StringComparison.InvariantCultureIgnoreCase); } public override int GetHashCode(){ return ToString().GetHashCode(); } static EncodedStreamFactory encoderFactory = new EncodedStreamFactory(); // Encodes the full email address, folding as needed internal string Encode(int charsConsumed) { string encodedAddress = String.Empty; IEncodableStream encoder; byte[] buffer; Debug.Assert(this.Address != null, "address was null"); //do we need to take into account the Display name? If so, encode it if (!String.IsNullOrEmpty(this.displayName)) { //figure out the encoding type. If it's all ASCII and contains no CRLF then //it does not need to be encoded for parity with other email clients. We will //however fold at the end of the display name so that the email address itself can //be appended. if (MimeBasePart.IsAscii(this.displayName, false)) { encodedAddress = String.Format("\"{0}\"", this.displayName); } else { //encode the displayname since it's non-ascii encoder = encoderFactory.GetEncoderForHeader(this.displayNameEncoding, false, charsConsumed); buffer = displayNameEncoding.GetBytes(this.displayName); encoder.EncodeBytes(buffer, 0, buffer.Length); encodedAddress = encoder.GetEncodedString(); } //the extra space is because there should be a non-printable whitespace char //following the fold (CRLF) and there is supposed to be a space between the display name and //the address so this is necessary. encodedAddress += "\r\n "; } //now we have the encoded display name (if present), we need to append the address to it. if (!String.IsNullOrEmpty(encodedAddress)) { //address should be enclosed in <> when a display name is present encodedAddress += SmtpAddress; } else { //no display name, just return the address encodedAddress = this.Address; } return encodedAddress; } } } // File provided for Reference Use Only by Microsoft Corporation (c) 2007. //------------------------------------------------------------------------------ // // Copyright (c) Microsoft Corporation. All rights reserved. // //----------------------------------------------------------------------------- namespace System.Net.Mail { using System; using System.Text; using System.Net.Mime; using System.Diagnostics; using System.Globalization; // // This class stores the basic components of an e-mail address as described in RFC 2822 Section 3.4. // Any parsing required is done with the MailAddressParser class. // public class MailAddress { // These components form an e-mail address when assembled as follows: // "EncodedDisplayname"private readonly Encoding displayNameEncoding; private readonly string displayName; private readonly string userName; private readonly string host; // For internal use only by MailAddressParser. // The components were already validated before this is called. internal MailAddress(string displayName, string userName, string domain) { this.host = domain; this.userName = userName; this.displayName = displayName; this.displayNameEncoding = Encoding.GetEncoding(MimeBasePart.defaultCharSet); Debug.Assert(host != null, "host was null in internal constructor"); Debug.Assert(userName != null, "userName was null in internal constructor"); Debug.Assert(displayName != null, "displayName was null in internal constructor"); } public MailAddress(string address) : this(address, null, (Encoding)null) { } public MailAddress(string address, string displayName) : this(address, displayName, (Encoding)null) { } // // This constructor validates and stores the components of an e-mail address. // // Preconditions: // - 'address' must not be null or empty. // // Postconditions: // - The e-mail address components from the given 'address' are parsed, which should be formatted as: // "EncodedDisplayname" // - If a 'displayName' is provided separately, it overrides whatever display name is parsed from the 'address' // field. The display name does not need to be pre-encoded if a 'displayNameEncoding' is provided. // // A FormatException will be thrown if any of the components in 'address' are invalid. public MailAddress(string address, string displayName, Encoding displayNameEncoding) { if (address == null){ throw new ArgumentNullException("address"); } if (address == String.Empty){ throw new ArgumentException(SR.GetString(SR.net_emptystringcall,"address"), "address"); } this.displayNameEncoding = displayNameEncoding ?? Encoding.GetEncoding(MimeBasePart.defaultCharSet); this.displayName = displayName ?? string.Empty; // Check for bounding quotes if (!String.IsNullOrEmpty(this.displayName)) { if (this.displayName.Length >= 2 && this.displayName[0] == '\"' && this.displayName[this.displayName.Length - 1] == '\"') { // Peal bounding quotes, they'll get re-added later. this.displayName = this.displayName.Substring(1, this.displayName.Length - 2); } } MailAddress result = MailAddressParser.ParseAddress(address); this.host = result.host; this.userName = result.userName; // If we were not given a display name, use the one parsed from 'address'. if (String.IsNullOrEmpty(this.displayName)) { this.displayName = result.displayName; } } public string DisplayName { get { return displayName; } } public string User { get { return this.userName; } } public string Host { get { return this.host; } } public string Address { get { return String.Format(CultureInfo.InvariantCulture, "{0}@{1}", userName, host); } } internal string SmtpAddress{ get{ return String.Format(CultureInfo.InvariantCulture, "<{0}>", Address); } } /// /// this returns the full address with quoted display name. /// i.e. "some email address display name" ////// if displayname is not provided then this returns only user@host (no angle brackets) /// public override string ToString() { if (String.IsNullOrEmpty(DisplayName)) { return this.Address; } else { return String.Format("\"{0}\" {1}", DisplayName, SmtpAddress); } } public override bool Equals(object value) { if (value == null) { return false; } return ToString().Equals(value.ToString(),StringComparison.InvariantCultureIgnoreCase); } public override int GetHashCode(){ return ToString().GetHashCode(); } static EncodedStreamFactory encoderFactory = new EncodedStreamFactory(); // Encodes the full email address, folding as needed internal string Encode(int charsConsumed) { string encodedAddress = String.Empty; IEncodableStream encoder; byte[] buffer; Debug.Assert(this.Address != null, "address was null"); //do we need to take into account the Display name? If so, encode it if (!String.IsNullOrEmpty(this.displayName)) { //figure out the encoding type. If it's all ASCII and contains no CRLF then //it does not need to be encoded for parity with other email clients. We will //however fold at the end of the display name so that the email address itself can //be appended. if (MimeBasePart.IsAscii(this.displayName, false)) { encodedAddress = String.Format("\"{0}\"", this.displayName); } else { //encode the displayname since it's non-ascii encoder = encoderFactory.GetEncoderForHeader(this.displayNameEncoding, false, charsConsumed); buffer = displayNameEncoding.GetBytes(this.displayName); encoder.EncodeBytes(buffer, 0, buffer.Length); encodedAddress = encoder.GetEncodedString(); } //the extra space is because there should be a non-printable whitespace char //following the fold (CRLF) and there is supposed to be a space between the display name and //the address so this is necessary. encodedAddress += "\r\n "; } //now we have the encoded display name (if present), we need to append the address to it. if (!String.IsNullOrEmpty(encodedAddress)) { //address should be enclosed in <> when a display name is present encodedAddress += SmtpAddress; } else { //no display name, just return the address encodedAddress = this.Address; } return encodedAddress; } } } // File provided for Reference Use Only by Microsoft Corporation (c) 2007.
Link Menu

This book is available now!
Buy at Amazon US or
Buy at Amazon UK
- _ScatterGatherBuffers.cs
- ConnectionStringsSection.cs
- GridLength.cs
- SiteMap.cs
- MethodExecutor.cs
- SafeEventLogReadHandle.cs
- WebConvert.cs
- LayoutUtils.cs
- Panel.cs
- HitTestDrawingContextWalker.cs
- DropTarget.cs
- GlobalProxySelection.cs
- ErrorFormatter.cs
- ObjectStorage.cs
- Separator.cs
- DataContractSerializerSection.cs
- PolyBezierSegment.cs
- Point3DCollectionConverter.cs
- ServiceParser.cs
- SamlAuthenticationClaimResource.cs
- ApplicationContext.cs
- BrowserDefinition.cs
- RuntimeHandles.cs
- NavigationWindowAutomationPeer.cs
- SecurityKeyUsage.cs
- DbgUtil.cs
- AnonymousIdentificationModule.cs
- WpfKnownTypeInvoker.cs
- Regex.cs
- RequestCacheEntry.cs
- ValuePattern.cs
- SafeFileHandle.cs
- CodeFieldReferenceExpression.cs
- StreamGeometry.cs
- FontUnit.cs
- SettingsProperty.cs
- StylusTouchDevice.cs
- MediaContext.cs
- SessionSwitchEventArgs.cs
- OleDbReferenceCollection.cs
- WebFormsRootDesigner.cs
- OnOperation.cs
- NavigationPropertyEmitter.cs
- DataGridHeaderBorder.cs
- DesignerAttribute.cs
- ItemCollectionEditor.cs
- PickBranchDesigner.xaml.cs
- DelegatingConfigHost.cs
- Quaternion.cs
- TemplatedMailWebEventProvider.cs
- UnmanagedMarshal.cs
- BrowserCapabilitiesFactory.cs
- XmlAttributes.cs
- DataGridViewCellErrorTextNeededEventArgs.cs
- QuerySettings.cs
- SchemaObjectWriter.cs
- HtmlTableRow.cs
- RemoteCryptoRsaServiceProvider.cs
- TextOutput.cs
- DataGridAutoFormatDialog.cs
- ConfigurationValue.cs
- ImageBrush.cs
- PointCollection.cs
- TranslateTransform3D.cs
- SystemIPInterfaceProperties.cs
- RuntimeIdentifierPropertyAttribute.cs
- PolyQuadraticBezierSegment.cs
- SevenBitStream.cs
- ImpersonateTokenRef.cs
- StreamingContext.cs
- PersonalizationAdministration.cs
- SrgsNameValueTag.cs
- _ScatterGatherBuffers.cs
- SqlTriggerAttribute.cs
- ToolStripSettings.cs
- ComboBoxRenderer.cs
- ToolStripPanelRenderEventArgs.cs
- DeclaredTypeElement.cs
- DurationConverter.cs
- _SSPIWrapper.cs
- XamlDebuggerXmlReader.cs
- ProxyElement.cs
- SecurityChannelFaultConverter.cs
- TrackPoint.cs
- ParserStreamGeometryContext.cs
- CatalogPartCollection.cs
- CodeGroup.cs
- xsdvalidator.cs
- PersonalizationStateInfo.cs
- ColorDialog.cs
- SevenBitStream.cs
- SizeConverter.cs
- WebReferenceOptions.cs
- Visual3D.cs
- WebPartCloseVerb.cs
- ViewKeyConstraint.cs
- HandlerMappingMemo.cs
- MultipleViewProviderWrapper.cs
- OdbcCommandBuilder.cs
- TailCallAnalyzer.cs