Socket.DontFragment Property

Definition

Возвращает или задает значение Boolean, указывающее, разрешает ли объект Socket выполнение фрагментации датаграмм протокола IP.Gets or sets a Boolean value that specifies whether the Socket allows Internet Protocol (IP) datagrams to be fragmented.

public:
 property bool DontFragment { bool get(); void set(bool value); };
public bool DontFragment { get; set; }
member this.DontFragment : bool with get, set
Public Property DontFragment As Boolean

Property Value

Boolean

Значение true, если объект Socket разрешает фрагментацию датаграмм; в противном случае — значение false.true if the Socket allows datagram fragmentation; otherwise, false. Значение по умолчанию — true.The default is true.

Exceptions

Это свойство может быть установлено только для сокетов в семействах InterNetwork или InterNetworkV6.This property can be set only for sockets in the InterNetwork or InterNetworkV6 families.

Произошла ошибка при попытке доступа к сокету.An error occurred when attempting to access the socket.

Socket был закрыт.The Socket has been closed.

Examples

В следующем примере кода демонстрируется применение атрибута DontFragment.The following code example demonstrates the use of the DontFragment property.

static void ConfigureUdpSocket(Socket^ udpSocket)
{

    // Set the Don't Fragment flag.
    udpSocket->DontFragment = true;
     
    // Enable broadcast.
    udpSocket->EnableBroadcast = true;
     
    // Disable multicast loopback.
    udpSocket->MulticastLoopback = false;
    Console::WriteLine("Udp Socket configured:");
    Console::WriteLine("  DontFragment {0}", 
        udpSocket->DontFragment);
    Console::WriteLine("  EnableBroadcast {0}", 
        udpSocket->EnableBroadcast);
    Console::WriteLine("  MulticastLoopback {0}", 
        udpSocket->MulticastLoopback);
}
static void ConfigureUdpSocket(Socket udpSocket)
{
    // set the Don't Fragment flag.
    udpSocket.DontFragment = true;
    // Enable broadcast.
    udpSocket.EnableBroadcast = true;

    // Disable multicast loopback.
    udpSocket.MulticastLoopback = false;

    Console.WriteLine("Udp Socket configured:");
    Console.WriteLine($"  DontFragment {udpSocket.DontFragment}");
    Console.WriteLine($"  EnableBroadcast {udpSocket.EnableBroadcast}");
    Console.WriteLine($"  MulticastLoopback {udpSocket.MulticastLoopback}");
}

Remarks

Для датаграмм требуется фрагментация, если их размер превышает максимальную единицу передачи (MTU) носителя передачи.Datagrams require fragmentation when their size exceeds the Maximum Transfer Unit (MTU) of the transmission medium. Датаграммы могут быть фрагментированы отправляющим узлом (все версии протокола IP) или промежуточным маршрутизатором (только для протокола IP версии 4).Datagrams may be fragmented by the sending host (all Internet Protocol versions) or an intermediate router (Internet Protocol Version 4 only). Если датаграмма должна быть фрагментирована, а параметр DontFragment установлен, датаграмма отбрасывается, а сообщение об ошибке протокола ICMP отправляется обратно отправителю датаграммы.If a datagram must be fragmented, and the DontFragment option is set, the datagram is discarded, and an Internet Control Message Protocol (ICMP) error message is sent back to the sender of the datagram.

Установка этого свойства для сокета протокола TCP не будет действовать.Setting this property on a Transmission Control Protocol (TCP) socket will have no effect.

Applies to